На Хабре
пишут:
3 простых правила, которые сделают из вас Суперзвезданутого Программиста...
Правило 3: Не тратьте время для документирование кода, или добавления небольших комментариев, объясняющих потенциальные ловушки, связанные с изменением нечетких участков кода. Вам это не нужно - вы пишете код.
Нужно сказать, что это правило весьма точно соответствует моему определению прогаммистов-мудаков.