Комментарии 6
Полезно, интересно. Добавлю в закладки. Буду иногда перечитывать!
0
Как-то читал книжку по паттернам. Там было что-то типа:
Если код нуждается в комментариях, то следует его переписать
0
Комментарии не всегда пишутся к коду как таковому. Иногда нужно комментировать сами [бизнес]-процессы под которые пишется код.
В теории такое конечно должно быть не в комментариях, а в ТЗ/документации. Но в реальности часто логичнее это добавить и в виде комментария. Как минимум в виде какой-то сслыки на нужное место в этой самой документации.
0
Абсолютное безусловное высказывание скорее всего ложное, если это не формализм.
Если код нуждается в комментариях, то высока вероятность, что его стоит переписать
0
А теперь сравните с этим комментарием (слегка изменён, чтобы защитить виноватых):
// Magical formula taken from a stackoverflow post, reputedly related to
// human vision perception.
return (int) (0.3 * red + 0.59 * green + 0.11 * blue);
Любой, кто захочет разобраться в коде, вынужден будет искать эту формулу. А если бы вставили ссылку, то можно было бы гораздо быстрее найти источник.
А ещё лучше — ссылаться не на stackoverflow, а на более авторитетный источник: например — на W3C, и вообще это — массово используемая и широко известная формула.
0
Только полноправные пользователи могут оставлять комментарии. Войдите, пожалуйста.
Лучшие практики написания комментариев к коду