Чем меньше коментариев к коду тем лучше. Коментировать нужно только а) API б) те куски которые не получается переписать вообще или в данный момент.