История изменений
Исправление
dzidzitop,
(текущая версия)
:
хотя есть ещё одно хорошее правило. если автор кода только несвязно мычит на вопрос «что делает этот код?», то код в любом случае переписывается, пока автор не начинает связно рассказывать что в коде происходит или это не становится очевидно после первого прочтения кода.
И в большом количестве случаев комментарии автора становятся комментариями в коде. В «самодокументированный» код не верю и не видел такого, кроме тривиального.
Исправление
dzidzitop,
:
хотя есть ещё одно хорошее правило. если автор кода только несвязно мычит на вопрос «что делает этот код?», то код в любом случае переписывается, пока автор не начинает связно рассказывать что в коде происходит или это не становится очевидно после первого прочтения кода.
И в большом количестве комментарии автора становятся комментариями в коде. В «самодокументированный» код не верю и не видел такого, кроме тривиального.
Исходная версия
dzidzitop,
:
хотя есть ещё одно хорошее правило. если автор кода только несвязно мычит на вопрос «что делает этот код?», то код в любом случае переписывается, пока автор не начинает связно рассказывать что в коде происходит или это не становится очевидно после первого прочтения кода.