Форум переехал на новый адрес: http://qsp.su



АвторСообщение





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


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

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

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

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

Спасибо: 0 
Профиль Цитата Ответить
Ответов - 23 , стр: 1 2 All [только новые]







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


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

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

Спасибо: 0 
Профиль Цитата Ответить
демиург




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


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



Спасибо: 0 
Профиль Цитата Ответить
moderator




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


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

Спасибо: 0 
Профиль Цитата Ответить
Ответов - 23 , стр: 1 2 All [только новые]
Ответ:
1 2 3 4 5 6 7 8 9
большой шрифт малый шрифт надстрочный подстрочный заголовок большой заголовок видео с youtube.com картинка из интернета картинка с компьютера ссылка файл с компьютера русская клавиатура транслитератор  цитата  кавычки моноширинный шрифт моноширинный шрифт горизонтальная линия отступ точка LI бегущая строка оффтопик свернутый текст

показывать это сообщение только модераторам
не делать ссылки активными
Имя, пароль:      зарегистрироваться    
Тему читают:
- участник сейчас на форуме
- участник вне форума
Все даты в формате GMT  3 час. Хитов сегодня: 6
Права: смайлы да, картинки да, шрифты да, голосования нет
аватары да, автозамена ссылок вкл, премодерация вкл, правка нет



Создай свой форум на сервисе Borda.ru
Текстовая версия