Отправлено: 10.02.10 15:47. Заголовок: Комментарии к коду - какими они должны быть?

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

Это все понятно, но практика имеет свои сложности. Пытаясь писать комментарии к собственным программам я не могу толком понять, а что именно требует комментариев? Где они уместны, а где нет? Какова граница между разумной экономией сил при написании и достаточной информацией для тех кто будет разбирать код потом?
Как вообще надо правильно писать комментарии к программе?

У меня пока все сводится к общему обозначению того что делает каждая локация, ну и в лучшем случае еще объяснение того за какое действие отвечают некоторые куски кода.

Может посоветуете хорошие статьи, примеры или просто дадите совет?

 Отправлено: 27.02.10 02:31. Заголовок: Шуткую я, барыня...

Шуткую я, барыня.

Хотя сказать по правде, если сам для игры чего прикидываю графически, то как раз на листочке. А4 мне хватает вполне. Но графов не строю - нужды нет.

 Отправлено: 27.02.10 04:53. Заголовок: MasterSet А я вообще..

MasterSet А я вообще все проектные записи в тетрадке делаю, по-старинке :))

 Отправлено: 27.02.10 09:01. Заголовок: Программка для постр..

Программка для построения графов маленькая и простенькая, называется Explain вот небольшой обзорчик http://www.mindmap.ru/stat/feod.htm
Мой граф к игре получается вот такой http://s003.radikal.ru/i201/1002/b7/cee46d54a614.jpg