Qualquer coisa melhor do que o PHPDoc lá fora?

Alguém usa qualquer outra coisa para documentar seu código PHP do que o PHPDoc? Existem ferramentas que lêem a mesma syntax de documentação, mas dão uma saída mais rica?

Também irei para o doxígeno.

Aqui estão vários motivos:

  • compatível com tags phpdoc e outros populares: é interoperável
  • trabalha com várias linguagens de programação: um investimento melhor tempo
  • Existem syntaxs alternativas: pode escolher o estilo de comentário que lhe convém
  • muito eficiente com formatação / marcação avançada / metadados
  • existe uma GUI que não está vinculada a nenhum IDE e a um plugin do eclipse também

E ainda grátis, multiplataforma e código aberto 🙂

É fácil de aprender, mas é mais difícil que o phpdoc seja muito mais rico.

Você pode tentar DocBlox; que se destina a ser uma alternativa para o phpDocumentor, mas com suporte para resources adicionais dos quais o suporte completo do PHP 5.3 é um. Um benefício adicional é que é bastante rápido e usa memory relativamente pequena.

Você pode ler mais em http://www.docblox-project.org ou ver uma demo em http://demo.docblox-project.org/default

Outra opção que não o phpDocumentor é a documentação Doxygen com suporte PHP .

Doxygen ( http://www.doxygen.org ).

ApiGen

http://apigen.org/

O ApiGen tem suporte para namespaces, pacotes, links entre documentação, referência cruzada para classs padrão do PHP e documentação geral, criação de código-fonte destacado e suporte experimental para características do PHP 5.4.

DocBlox

http://www.docblox-project.org/

API compatível com PHP 5.3 Gerador de documentação voltado para projetos de todos os tamanhos e continuous integration.

capaz de analisar e transformar completamente o Zend Framework 2

Eu também estou usando Doxygen – você se acostume com as várias palavras-chave muito rápido – eles são um pouco auto-explicativos. 😉

RubyDoc também é bom, eu gosto especialmente do layout dos rdocs.

Eu não usei isso com o PHP, mas o doxygen afirma apoiar o idioma.

Doutrina usa PHPDoctor, que parece funcionar bem com 5.3 em meus testes.

http://peej.github.com/phpdoctor/#download

Se você precisa digitar o código para o PHP 5.3+, por exemplo. Se ele usa namespaces, Ted Kulp’s fork of PHPDoctor pode ser a sua resposta.

Intereting Posts