[PHP] Комментарии в коде⁠⁠

Если код нуждается в комментариях, наверное он просто плохо написан. Зачем комментировать регулярку, когда можно правильно назвать переменную с ней? Зачем комментировать каждый метод когда можно дать адекватное имя? Единственное где нужны комментарии - объяснить ПОЧЕМУ именно такой алгоритм действий выбран или ЗАЧЕМ используется метод.
Ах, да! Это ведь не типизированный php - тогда можно добавлять коммент с указанием типа возвращаемого функцией результата и тип пропертей/переменных, всё что нужно чтобы работал автокомплит.
Остальные комменты превращаются в шум.

PS в крупных, огромных проектах ещё нужны комментарии к публичному АПИ со всеми его java/php/ng/{любой другой язык} docs.