[Moscow.pm] Доки

[Тельминов Сергей]

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

Или все умеют писать программы так, что и без доки понятно (хотя бы 
самому)? Может я просто плохо пишу?

Andrew Shitov пишет:
> Как вы заставляете коллег (подчиненных) писать документацию?
>
> Сегодня же написать минимальную документацию очень просто: есть вики,
> есть поды, есть что угодно. Не хотят, суки :-)
>
>