Веб Мастерская | Веб разработка и программирование | ИТ | IT
Без категории · 4 августа 2026 г.
ВОПРОС:
ВОПРОС: Насколько продуманно вы комментируете свой код? Коллеги, признавайтесь: писали когда-нибудь комментарий // увеличиваем на 1, а через полгода смотрели на него и думали: «Зачем?! Зачем ты мне это написал?» Комментарии — это не доказательство, что вы тут были. Это письмо себе в будущее. Или тому бедолаге, который будет править ваш код после отпуска. Вот три правила из мастерской, которые реально экономят время: 1. Комментируйте «почему», а не «что» Плохо: // фильтруем массив по статусу Хорошо: // отсекаем отменённые заказы: клиент уже вернул деньги, в отчёт не попадают «Что делает код» видно из самого кода. «Почему именно так» — нет. 2. Не комментируйте очевидное $i++; // увеличиваем счётчик Спасибо, кэп. Если нужно объяснять каждую строку — меняйте код, а не плодите комментарии. 3. Помечайте «костыли» и временные решения // TODO: убрать после миграции на новый API (задача #247) Такой комментарий — маячок. Без него «временное» живёт годами и обрастает мифами. И да, закомментированный кусок кода на 200 строк — не комментарий. Это мусор. Для истории есть git. Хороший комментарий отвечает на один вопрос: что здесь происходит такого, чего не видно из кода? Если ответ «ничего» — не пишите. Вот так. Идем кодить дальше! 🚀 #вебразработка #webdev #webdevelopment #frontend #backend #fullstack #созданиесайтов #php #js #html #css #mysql #seo #сео #ВебМастерская #СтудияАбрамова #АбрамовВеб