Или это просто "законченное" состояние? Я использовал PHPDoc много лет на всех моих проектах PHP, но недавно заметил, что последний пост на веб-сайте PHPDoc был с 2008 года. Поэтому мне интересно, стоит ли заглядывать в другие альтернативы, такие как Doxygen. Существуют ли какие-либо преимущества для использования чего-то другого, кроме PHPDoc?
EDIT: Интересная публикация в 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 хороший вызов
* UPDATE: Таким образом, DocBlox является PHPDocumentor2 в маскировке/ремаркетинге. http://www.docblox-project.org/
Недавно я использовал Doxygen для создания документации для PHP. Это инструмент с открытым исходным кодом для документации и поддержки других языков. Я бы сказал, что это хороший инструмент, и он также легко создает документацию как диаграммы классов и имеют множество настраиваемых функций. Он доступен для Windows, а также для UNIX/LINUX
Хотя в настоящее время я использую doxygen, тоже должен опубликовать, что PHPDocumentor не мертв. Вместо этого попытки проекта DocBlox объединяются, чтобы сформировать основу для PHPDocumentor2, которые занимают новый веб-сайт. В эти дни я не уверен, что производство готово, но оно действительно выглядит действительно многообещающим.
Зачем исправить что-то, что не сломалось? PHPDoc отлично работает, на самом деле ничего не нужно. Они не пытаются внедрять инновации, просто чтобы помочь создать документацию. Что они сделали, очень хорошо.
У меня было несколько проблем с phpDocumentor. Одним из них был экспорт xml. После нескольких попыток исправить код я решил искать альтернативу.
То, что я нашел и понравилось, было: Rarangi https://bitbucket.org/laurentj/rarangi/wiki/Home
Rarangi is a generator of documents from php source code.
Интересная вещь в том, что она сохраняет информацию в mysql db, и вы можете создавать свои собственные отчеты.