Поясню сабж: процесс кодирования сильно зависит от специфики задачи и общего процесса разроботки (проектирования, тестирования, документирования). Комментарии в этом смысле можно отнести к различным потокам работы (workflow) или скорее к некотрой связке между ними. Поэтому возникает вопрос на каком этапе их писать? Можно писать сразу: закодил метод — закооментировал. Можно после успешной сборки, можно даже перед кодированием, а ля автотесты. Зачастую приходится слышать, как начальство требует комментарии, что лично мне, например, не убобно, потому как код постоянно меняется и их приходится переписывать, на что собственно уходит время. С другой стороны, если их не писать сразу, то потом когда все заработало и продается уже вроде и не надо как-то.
Вот и хочется услышать соображения на этот счет. Поделитесь опытом.
