Некоторые программисты уж очень не любят документировать свой код и доводить его до того уровня, когда приходится специально открывать классы, смотреть функции, пробегаться по Outline редактора, лишь для того чтобы узнать что делает тот или иной метод. Это занимает кучу времени, да и нервов менеджеров вроде меня на это просто не хватает. Я использую в разработке софта Aptana и там есть отличное средство называемое ScriptDoc.