[Krusty]

Лучшим описанием программы является сам код.
Если у нас более-менее правильные имена переменных, классов, иерархия итд, причем этот код - это наш собственный, то разобраться в нем не особо сложно.
Самый нужный комментарий-описание не того, что мы сделали, а того, чего мы не сделали и почему.