Каков статус PHPDoc? [закрыто]

Закрыт. Этот вопрос не по теме . В настоящее время он не принимает ответов.

Хотите улучшить этот вопрос? Обновите вопрос , чтобы он был по теме для переполнения стека.

Закрыт в прошлом году .

I никогда раньше не заботился о документировании своего кода, но недавно я начал работать над проектом с открытым исходным кодом, и возникла необходимость.Очевидно, что «оружием выбора» является PHPDoc, но ...

Я не смог найти ни одной спецификации стандарта PHPDoc. В википедии есть запись, в которой перечислены некоторые свойства, и есть проект phpDocumentor, который предположительно есть более обширный словарь, но что меня озадачивает, так это где полное руководство по PHPDoc? Существует ли единый стандарт или все эти многочисленные подделки phpDocumentor должны расширять «стандарт» PHPDoc (если таковой имеется) до того, что они кажутся подходящими .

Если мы предположим, что phpDocumentor - это место, где создается и поддерживается стандарт PHPDoc, все выглядит довольно мрачно, поскольку веб-сайт проекта мертв уже почти 4 года. И что меня озадачивает. Более того, около месяца назад версия 1.4.4 внезапно появилась из мертвых на сайте Pear phpDocumentor.

Я знаю, что здесь есть намного более умные и знающие люди, поэтому я хотел бы знать, в чем дело с PHPDoc. Есть ли единый орган, который создает стандарт? Насколько это надежно? Есть ли будущее, или мы имеем дело с зомби, и вся надежда потеряна ...

Спасибо, Иво

задан Ivo Sabev 2 January 2012 в 05:30

0 ответов

Другие вопросы по тегам:

php documentation phpdoc

Каков статус PHPDoc? [закрыто]

0 ответов

Похожие вопросы: