Коментарии - не панацея. Программа должна состоять из исчислимого
количества сущностей и их взаимодействий. Без подпространственных
переходов. Мне очень импонирует идиома Питона:
Красивое лучше, чем уродливое.
Явное лучше, чем неявное.
Простое лучше, чем сложное.
Сложное лучше, чем запутанное.
Плоское лучше, чем вложенное.
Разреженное лучше, чем плотное.
Читаемость имеет значение.
Особые случаи не настолько особые, чтобы нарушать правила.
При этом практичность важнее безупречности.
Ошибки никогда не должны замалчиваться.
Если они не замалчиваются явно.
Встретив двусмысленность, отбрось искушение угадать.
Должен существовать один и, желательно, только один очевидный способ сделать это.
Хотя он поначалу может быть и не очевиден, если вы не голландец [^1].
Сейчас лучше, чем никогда. Хотя никогда зачастую лучше, чем прямо сейчас.
Если реализацию сложно объяснить — идея плоха.
Если реализацию легко объяснить — идея, возможно, хороша.
Пространства имён — отличная штука! Будем делать их больше!
Cкpипaч, пророк (13.01.2022 19:05, просмотров: 209) ответил Nikolay_Po на Я думаю, что с некоторого уровня зрелости, хороший знаток языка
сможет специально писать программу просто и понятно. В крайнем
случае, если заинтересовать, может оставлять достаточно
комментариев, чтобы через пять лет смог быстро разобраться даже не
знаток.