Возможный дубликат:
Автоматическое создание документации PHP?
Я новичок в PHP, и моя текущая работа требует от меня очень быстрого изучения языка.
Я приверженец документации. Я даже люблю писать документацию. Я знаком с принятым синтаксисом документации и инструментами для нескольких языков.
Это не относится к PHP.
Я знаю, что всегда есть несколько методов написания комментариев к исходному коду, пригодных для документации, и обычно для каждого языка существуют разные инструменты. Однако я нахожусь в среде, которая не требует ни стандартного способа комментирования, ни стандартного инструмента PHP autodoc. Это дает мне свободу выбора и немного паралича за анализом, чтобы согласиться с этим.
Является ли phpDocumentor (http://www.phpdoc.org/) приемлемым стандартным инструментом для автодокументации PHP?
Допустимо ли следовать общим рекомендациям JavaDoc для кода при документировании кода PHP?