LINUX.ORG.RU

Re: Про комментирование кода...

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

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

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

aton ()

Re: Про комментирование кода...

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

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

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

aton ()
Ответ на: Re: Про комментирование кода... от aton

Re: Про комментирование кода...

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

UVV ★★★★★ ()

Re: Про комментирование кода...

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

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

CrazyPit ★★★ ()

Re: Про комментирование кода...

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

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

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

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