(продолжение) Пояснения к коду От этого тоже лучше отказаться | Veras IT

(продолжение)
Пояснения к коду

От этого тоже лучше отказаться, но если всё же код не очень понятен, то лучше писать не что делает код, а для чего. Ведь скорее изменится сам код и его логика , а не то для чего это делается.

Для себя вижу только вижу только две ситуации когда комментарии точно оправданы.

Первая - это фикс неочевидного бага, когда требуется какая-то контринтуитивная реализация и нужно чтоб эту часть кода никто не трогал.

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