Информация об изменениях

Сообщение Re: Нужно ли комментировать код? от 20.01.2022 21:23

Изменено 20.01.2022 21:23 bnk

Re: Нужно ли комментировать код?
Здравствуйте, gress, Вы писали:

G>Столкнулась с новым веянием, согласно которому считается, что код комментирует себя сам. И комментарии не только не нужны, а вообще вредны.

G>Так как я боец старой формации, для меня это дикость. Но тут так получилось, что я сейчас тим лид, а мнения в команде разделились.
G>Поэтому интересно, я действительно динозавр и код теперь никто не комментирует?

Ну как, во всем нужен баланс
Не нужно вещи, которые и так очевидны если посмотреть на код.
Вещи, которые не очевидны, комментировать все еще нужно.

То есть, хорошие комментарии должны скорее отвечать не на вопрос "как" а на вопрос "зачем", или "почему так, а не иначе".
Re: Нужно ли комментировать код?
Здравствуйте, gress, Вы писали:

G>Столкнулась с новым веянием, согласно которому считается, что код комментирует себя сам. И комментарии не только не нужны, а вообще вредны.

G>Так как я боец старой формации, для меня это дикость. Но тут так получилось, что я сейчас тим лид, а мнения в команде разделились.
G>Поэтому интересно, я действительно динозавр и код теперь никто не комментирует?

Ну как, во всем нужен баланс
Не нужно комментировать вещи, которые и так очевидны если посмотреть на код.
Вещи, которые не очевидны, комментировать все еще нужно.

То есть, хорошие комментарии должны скорее отвечать не на вопрос "как" а на вопрос "зачем", или "почему так, а не иначе".