..

title: комментарии

Комментарии - это тоже часть кода. Следовательно:

  1. нужно поддерживать их актуальность
  2. они могут вводить в заблуждение, если устарели или написаны некорректно
  3. Лучший код такой, который не требует комментариев

Однако, есть случаи, когда комментарии необходимы:

  1. когда из-за оптимизации код стал менее читаемым и сделать его читаемым нельзя (очень сложно)
  2. когда для корректности работы нужно сделать что-то неочевидное