12 подписчиков
Комментарии в коде
Многим знаком термин «самодокументируемый код», который зачастую трактуется, как отсутствие комментариев. Ибо зачем комментарии? Хороший же программист и без них должен уметь писать понятно. Проблема в том, что это невозможно.
Периодически приходится решать достаточно сложные задачи, которые тяжело объяснить при помощи обычной речи, да еще в придачу с доской и фломастерами, т.е. имея богатый набор инструментов для коммуникации. Засунуть это объяснение в текст уже само по себе сложная задача, а уж в текст, написанный на одном из языков программирования, усложняет все многократно. Любой язык программирования имеет гораздо больше ограничений для передачи своих мыслей по сравнению с обычным языком. Поэтому не стоит избегать комментариев, зачастую тот, кто будет изучать ваш код, скажет вам огромное спасибо за них.
При этом конечно же все хорошо в меру. В тех случаях, где можно обойтись без комментариев (хотел написать средствами ЯП, но комментарии тоже к ним относятся), лучше это сделать.
#Пирязев Дмитрий
Около минуты
25 января 2023