Другие языки программирования и технологии

Комментируете ли вы свой исходный код? Почему?

Лично я в своих исходниках крайне редко что то комментирую по двум причинам: 1) умные поймут и без комментариев 2) глупым мои комментарии врятли чем то помогут
ВК
Владимир Курышев
12 779
Коменты вида
A := 10; // Переменная A становиться равной 10 - школярский даунизм

с некоторым количеством практики приходит навык записей типа

// триангуляция. Насажена с книги "....", адаптирована к нашему случаю.
// ! В MyArray индексация с 0, а не с 1 как везде (передрана реализация на C/C++)
// управление транзакциями на совести вызывающей программы
// если человек отработал больше XX лет - начислить выслугу лет

в хороших букварях это все расписано
VN
Vadik Nosonov
730
Лучший ответ
В сложных и неочевидных местах, или там где зарыт основной business logic.
Еще в начале каждого модуля краткую аннотацию пишу.
Если что-то ни при каких обстоятельствах нельзя менять, а очень хочется - тоже пишу.
Если где-то задел на будущее оставлен - краткое ToDo пишу.
Если делаю пакеты PL/SQL - вот там все пишу, потому что иначе через 3 дня уже ничего непонятно - за нагромождением конструкций SQL никакую логику разглядеть уже нельзя.

А вообще-то стараюсь код писать так, чтобы он читался на манер естественного языка. Крайне способствует.
Кирилл Пилюгин
Кирилл Пилюгин
50 600
Это моё личное дело!
ВК
Ваня Куприн
51 756
обязательно

иначе через некоторое время сам не понимаешь чего понаваял.. .

а так хоть комментарии почитал и может быть понял

:)
Станислав Пасынков
Станислав Пасынков
70 540
в проге из трёх строк коменты ни к чему.
А в реальном проекте, сейчас ты может и помнишь что, где и как.
А пройдёт время - будешь репу чесать и разбираться что и зачем тут.

PS imho, в чужих каракулях разбираться, проще не работающий кусок целиком переписать
YB
Yersultan Baizhanov
99 187
Владимир Курышев я иногда и в своих каракулях лучше перепишу, чем отлажу))
Кирилл Пилюгин Переписывать можно только тогда, когда ты точно знаешь, как эта херня должна работать. А переписывать 10000 строк из-за того, что где-то ошибочка вылетает, не есть разумно. И не всегда помогает... Я тут на днях мучал древний чужой код, который отработав лет 10 вдруг стал рандомно валиться на ровном месте. А оказалось, это индекс в базе запоролся, и код тут ни при чем вообще.
Переписывать хорошо как раз собственный код, когда после 20-ой модификации понимаешь, что эти макароны пора выбрасывать, и сделать все чистенько.
Я тоже ничего не комментирую когда пишу сам для себя.
Многие строки и так понятны без комментариев если давать нормальные названия переменным.
Но если дорабатываешь чужой код часто требуют делать комменты.
Гриша Антузинский
Гриша Антузинский
61 505
Комментарии обязательно делаю в коммерческих проектах. Удобно самому поддерживать. На ответах - никогда не делаю, только если очень просят )).
Kuba Nazarbaev
Kuba Nazarbaev
35 996
В основном код самокомментирующийся
ДЕ
Денис Емельянов
22 045
Нет. Потому что кроме меня это ни кому не надо
Денис Муравьев
Денис Муравьев
5 951
Владимир Курышев аналогичная ситуация)) Но даже если б кому то что то и понадобилось, мне проще послать его к учебникам))
Обязательно комментирую. Особенно те места, где код может быть не логичен с первого взгляда. Комментарии в будущем помогают сэкономить много времени. Нет необходимости долго "втыкать", что делает тот или иной блок программы.

Комментарии нужны, комментарии важны. ИМХО.
V- -F
V- -F
2 407
если работаю над большим проектом то ДА.
Денис Б
Денис Б
1 343
для себя удобно чтобы быстрее искать то что нужно исправить т. к. я начинающий... ну это по крайней мере мне так удобно в игровом движке
Дмитрий Минченков
Дмитрий Минченков
1 017

Похожие вопросы