Правила программирования. Стиль кодирования

Правило очень простое:

Если ты не следуешь одному стилю кодирования в проекте, ты мудак.

Это правило не обсуждается, и никаких других интерпретаций быть не может.

Правило относится к числу так называемых командных правил. Оно расширяется до следующей формулировки:

Если команда не следует единому стилю кодирования в проекте, каждый член команды — мудак.

Код независимо от того, сколько человек над ним работает, должен выглядеть так, как будто он написан одним человеком.

Это важно, потому что облегчает понимание кода текущей командой в будущем и упрощает введение в проект новых людей. Для индивидуального разработчика правило тоже имеет смысл, поскольку единый стиль со временем устройняет код, укрепляет мозги, структурирует инженерное видение, делает человека дороже на рынке труда.

Почти для каждого языка программирования существуют автоматические средства проверки стиля кодирования. Необходимо в своей команде настроить их таким образом, чтобы без проверки формальных требований ко внешнему виду код даже не доходил до просмотра людьми (код-ревью). C помощью дешёвого машинного труда освобождается часть дорогого человеческого времени (см. правило про автоматизацию).

(В команде Сиджеко код даже не попадёт в основной репозиторий, пока не будет выглядеть красиво.)

программирование правило команда

комментс паверед бай Дискас