LINUX.ORG.RU

Комментирование это вот:

int main()
{
  //  int i,j; Вот это и есть комментирование
}

Надо не комментировать, а документировать. Реальность такова, что
зачастую заказчик просто не принимает код без документирования ( детализация зависит от ситуации ). 

aton
()

Комментирование это вот:

int main()
{
  //  int i,j; Вот это и есть комментирование
}

Надо не комментировать, а документировать. Реальность такова, что
зачастую заказчик просто не принимает код без документирования ( детализация зависит от ситуации ). 

aton
()
Ответ на: комментарий от aton

> Реальность такова, что зачастую заказчик просто не принимает код без документирования.
Ты сам в коде утонешь без комментариев.
Сам честно скажу, комментировать начал три года назад...
и вдруг, взглянул на код четырёхлетнеё давности.
Я не сразу понял, что я написал.

UVV ★★★★★
() автор топика
Ответ на: комментарий от aton

> Всех под себя не равняй.
Хорошо.

UVV ★★★★★
() автор топика

> при недописанном коде нужны FIXME и TODO (и IDE, которая их сама находит и показывает).

Бедные, бедные люди, не знают что такое grep

CrazyPit ★★★
()

В последнее время к ТЗ прикладываю правила форматирования и комментирования кода(включая правила выбора имен переменных и пр.), исполнение которых обязательно. А так же стал практиковать подобные правила к SQL-коду. И жить стало легче, и модифицировать код стало проще,ибо ещё полно любителей называть переменные по типу "qweqwxaff", разделитель блока операторов "{" ставить посреди строки, а комментарии вообше не юзать.

Код должен быть красивым :-) ибо

"То, что не красиво - не продаётся" (С)

r_asian ★☆☆
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.