Всем привет!  На связи - #сквозьпризмувебразработки
Не комментируйте свой код. Почему стоит этого избегать?

Такой подход может быть взят во внимание, однако это не означает, что комментарии не нужны вовсе. Комментарии могут быть полезны, если они добавляют ценность, объясняют сложную логику или документируют особенности кода. Однако, следует избегать нескольких типов комментариев, которые могут создавать путаницу и беспорядок:
Избыточные комментарии: Комментарии, которые просто повторяют синтаксис кода, являются избыточными и не добавляют ценности. Если код написан понятно и читаемо, то часто дополнительные описания могут быть излишними.
Комментарии, вводящие в заблуждение: Если комментарий становится неточным или устаревшим, он может привести других программистов в заблуждение. Важно обновлять комментарии вместе с изменениями кода или лучше использовать самодокументирующийся код, который не требует пояснений. 
Шумовые комментарии: Комментарии, которые не несут новой информации или добавляют только общие фразы, могут быть просто шумом. Лучше фокусироваться на ясном объяснении сложных частей кода или на документировании важных принципов.
Комментарии к замене функции или переменной: Если код требует комментариев для объяснения сложной строки или выражения, возможно, стоит переосмыслить его структуру или разбить на более понятные компоненты. Читаемый код сам по себе должен быть понятным без слишком многословных комментариев.
Комментарии авторства: Добавление подписей в коде для указания авторства может быть излишним, особенно при использовании систем управления версиями, которые уже отслеживают историю изменений. Дополнительные строки с авторством могут только засорять код и усложнять его чтение.
В целом, комментарии следует использовать там, где они действительно нужны, чтобы улучшить понимание кода другими программистами. Однако, лучшим решением всегда будет писать понятный и самодокументирующийся код, который не требует излишних пояснений.
Уникальность текста  - https://vk.cc/co9g5f
#fullstack@throughlensdevelop, #fullstack, #frontend@throughlensdevelop, #frontend, #backend@throughlensdevelop, #backend, #php@throughlensdevelop, #php, #node@throughlensdevelop, #node, #junior@throughlensdevelop, #junior, #блогkidys, #блогденисакитаева