Комментарии внутри кода классов должны соответствовать
синтаксису комментариев PHPDoc, который напоминает Javadoc.
За дополнительной информацией о PHPDoc обращайтесь сюда:
http://www.phpdoc.org/
Дополнительные комментарии, кроме тех, что предусмотрены PHPDoc,
только приветствуются. Основное правило в данном случае - каждая
часть кода повышенной сложности должна быть прокомментирована до того, как
вы забыли как она работает.
Подходят комментарии в стилях C (/* */) и C++ (//).
Использование комментариев в стиле Perl/shell (#) не рекомендуется.
