💻 Зачем оставлять комментарии к странным участкам кода

Разработчик открывает файл с логикой расчёта скидок, написанный год назад, и видит сложную формулу без описания. Приходится тратить полчаса, чтобы восстановить логику работы функции и понять, почему часть условий прописана именно так.

Чтобы не тратить время на повторное исследование своего же кода, достаточно добавлять короткие комментарии к нестандартным решениям. Описывайте не то, что делает код — это и так видно, — а причину выбора конкретного алгоритма или ограничения. Через год эта заметка сэкономит вам полноценный рабочий день.

Наша группа ВК · Наш сайт ТГ @archive0studio

В этом посте были ссылки, но мы их удалили по правилам Сетки