[Moscow.pm] Доки
Тельминов Сергей
telminov на kdl-test.ru
Пт Ноя 28 06:43:42 PST 2008
Для себя же лучше документировать проги - откроешь, бывало, код месячной
давности и тратишь на него вермя, чтобы просто вспомнить/понять, что где
возвращается и с какой целью, и кем потом используется, и почему именно
так, и...
А так в доку заглянул, или коменты в коде почитал, - и сразу основные
вещи освежил/понял. В код вчитываешься уже в небольших кусках, где нужно
знать все в деталях.
Или все умеют писать программы так, что и без доки понятно (хотя бы
самому)? Может я просто плохо пишу?
Andrew Shitov пишет:
> Как вы заставляете коллег (подчиненных) писать документацию?
>
> Сегодня же написать минимальную документацию очень просто: есть вики,
> есть поды, есть что угодно. Не хотят, суки :-)
>
>
Подробная информация о списке рассылки Moscow-pm