PhpDocumentor мертв?

Question

Или это просто в «готовом» состоянии? Я много лет использовал PHPDoc во всех своих проектах PHP, но недавно я заметил, что последний пост на сайте PHPDoc был в 2008 году. Поэтому мне интересно, не пора ли рассмотреть другие альтернативы, такие как Doxygen. Есть ли какие-либо преимущества в использовании чего-то кроме PHPDoc?

РЕДАКТИРОВАТЬ: Интересный пост в Dev Zone сегодня, когда Мэтью объявил о выпуске Zend Framework 1.11.5, он написал:

"Майк ван Риэль предложил преобразовать нашу генерацию документации API в DocBlox. Мы уже рассматривали это для ZF2, но увидели гибкость системы шаблонов и, что более важно для нас с точки зрения упаковки, скорость и минимальные ресурсы, которые он использует для генерации выходных данных, мы были проданы (время создания документации API было сокращено с 80-100 минут до менее чем 10.) Вы можете просмотреть результаты самостоятельно. " http://devzone.zend.com/article/13643

Вот почему я обеспокоен тем, что если крупные проекты, такие как Zend Framework, удаляют phpDoc, мне кажется, что неактивность phpDoc не останется незамеченной. 100 минут до 10 ... это то, что мне нравится слышать.

@ gms8994 хороший звонок

* ОБНОВЛЕНИЕ: Оказывается, DocBlox - это PHPDocumentor2 в маскировке / ребрендинге. http://www.docblox -project.org /

Answer 1

Хотя я в настоящее время тоже использую doxygen, я должен сообщить, что PHPDocumentor не умер. Вместо этого попытки, предпринятые проектом DocBlox , объединяются, чтобы сформировать основу для PHPDocumentor2 , на котором представлен новый веб-сайт. В наши дни я не уверен, что это производство готово, но оно уже выглядит действительно многообещающим.

Answer 2

У меня было несколько проблем с phpDocumentor. Одним из них был экспорт XML. После нескольких попыток исправить код я решил поискать альтернативу.

То, что я нашел и понравилось, было: Rarangi https://bitbucket.org/laurentj/rarangi/wiki/Home

Rarangi is a generator of documents from php source code.

Интересно то, что он сохраняет информацию в базе данных mysql, и вы можете создавать собственные отчеты.

Answer 3

Я недавно использовал Doxygen для создания документации для PHP. Это инструмент с открытым исходным кодом для документации и поддержки других языков. Я бы сказал, что это хороший инструмент, который легко генерирует документацию, а также диаграммы классов и имеют множество настраиваемых функций. Он доступен для Windows, а также UNIX / LINUX

Может найти последнюю версию и скачать здесь

Answer 4

Зачем чинить то, что не сломано?PHPDoc прекрасно работает, больше ничего не нужно.Они не пытаются вводить новшества, просто чтобы помочь создать документацию.Что они и сделали, очень хорошо.