Как сделать код поддерживаемым
Как добиться того, чтобы ваш код был понятен коллегам, которым придется с ним работать? Обычно рекомендуют какое-то наивное шаманство: давайте переменным и функциям говорящие имена. Делайте функции не слишком длинными, не слишком короткими. Пишите комментарии, да не в стиле i=0 /*обнулим значение i*/, а объясняющие происходящее в глобальном контексте. Как будто содержание комментариев, имена переменных или длина функций имеют значение.
Нет, единственный способ - это писать нужный код. Вот тогда разберутся и будут хорошо его понимать.
Нет, единственный способ - это писать нужный код. Вот тогда разберутся и будут хорошо его понимать.
(Я просто зашел покормить троллей. Но ты первый начал.)
И выкинуть языки которые это требуют.
Писать комментарии надо не что там происходит (это итак нормальный потомок разберётся)
надо писать зачем оно изначально вообще писалось. Вот это как правило та ещё загадка, отсутствие ответа на которую серьёзно мешает.
А вот такие комментарии практически никто не пишет, пишут бессмысленное "вот тут мы берём значение X и передаём в ф-ию Y" - а я что, без комментария не вижу чтоли?!
Edited at 2017-10-18 11:50 am (UTC)