phpDocumentor Avaliações e Detalhes do Produto

- Facilidade de uso

- Geração direta de documentação a partir do código e visibilidade dos comentários de origem

- Conexão direta com a hierarquia de classes/namespace

- Achei o recurso de geração de UML bastante útil, pois usamos ferramentas de modelagem

- Configuração relativamente fácil, mesmo para projetos legados, e suporte via PHARs (legal!)

- Gosto do fato de que você apoia seu código gerando sua própria documentação com o PHPDocumentor Análise coletada por e hospedada no G2.com.

Encontrei um pouco difícil controlar como as coisas são organizadas no resultado final. Por exemplo, a ordenação personalizada de classes/namespace seria ótima. Análise coletada por e hospedada no G2.com.

A facilidade que a ferramenta me propôs para gerar a documentação diretamente a partir do código-fonte do PHP, deixando meu projeto mais robusto e autoral, usando a ferramenta javadoc que posso adicionar comentários relevantes e descartar documentação repetitiva, formando uma única documentação em vários formatos, com um grande objetivo para mim de fornecer todas as ferramentas e recursos necessários para escrever uma documentação eficaz e abrangente com o menor esforço possível. Tendo um sistema de templates flexível que permite mudar sua saída de diferentes maneiras e com vários modelos, frameworks, arquiteturas plugáveis, como WordPress ou PyroCms, entre outros. Análise coletada por e hospedada no G2.com.

Não houve coisas negativas durante o meu uso. O software tem funcionalidades com funções que acrescentam muito à organização. Análise coletada por e hospedada no G2.com.

Eu comecei a usar o phpDocumentor desde 2010. E essa ferramenta é muito útil para documentar minha biblioteca PHP. Análise coletada por e hospedada no G2.com.

Para mim, não houve desvantagens no phpDocumentor. Mas só é necessário disciplina para executá-lo e atualizar a documentação do código. Análise coletada por e hospedada no G2.com.

phpDocumentor é uma ferramenta e formato de documentação de código muito popular para PHP. Análise coletada por e hospedada no G2.com.

Um dos maiores aborrecimentos do PhpDocumentor era tentar escrever documentação no estilo DocBook para parte do manual, e documentação de docblock para outra parte. Análise coletada por e hospedada no G2.com.

Isso é útil porque podemos navegá-los mais rapidamente do que arquivos de código e obter uma documentação muito boa que pode ser distribuída a todos os desenvolvedores da equipe, prestadores de serviços terceirizados ou novas pessoas em sua equipe sem muito trabalho adicional. Análise coletada por e hospedada no G2.com.

Está quase desatualizado.. Não há mais desenvolvimento ou aprimoramento significativo Análise coletada por e hospedada no G2.com.

A facilidade da interface do usuário e o conteúdo geral são muito informativos. Análise coletada por e hospedada no G2.com.

Junto com os tópicos, deveria haver mais exemplos. Análise coletada por e hospedada no G2.com.

Fácil sintaxe

Suportado por IDEs

Embutido no código Análise coletada por e hospedada no G2.com.

Sem suporte para parâmetros com arrays tipados aninhados nem para arrays de chave-valor. Análise coletada por e hospedada no G2.com.

Automatizando a geração de comentários. Os comentários têm a estrutura correta. Análise coletada por e hospedada no G2.com.

Os comentários em casos muito raros precisam de correção. Análise coletada por e hospedada no G2.com.

Eu realmente gosto de sua funcionalidade em si, é uma ferramenta que nos permite auto-documentar o código que escrevemos na linguagem PHP e isso é feito automaticamente usando o código-fonte. Eu realmente gosto que, ao fazer uso de uma ferramenta como esta para todo o código que programamos, nos permite ter como uma espécie de modelo de documentação que nossos códigos têm e poder entender mais facilmente o que é programado e quais funções são as que se encontram em cada seção, eu realmente gosto que usar esta ferramenta nos permite continuar facilmente o código deixado por algum outro programador ou que algum colaborador continue facilmente o código criado por nós, já que nos permite ter uma boa documentação. Eu também gosto muito que nos permite migrar todo o código para um arquivo HTML com um grande grau de detalhe de tudo, desde comentários até funções, variáveis, entre outras coisas. Análise coletada por e hospedada no G2.com.

Basicamente, o único ponto negativo é a pequena comunidade que possui e que talvez ainda não seja uma ferramenta que recebeu o reconhecimento que merece, mas a verdade é que é uma ferramenta que força o programador a ter uma boa prática de codificação. Análise coletada por e hospedada no G2.com.

É o máximo, já que, como programador e para tempos de execução, é difícil comentar o código, esta ferramenta faz a análise do código-fonte e gera um arquivo seguindo os padrões de programação, o que ajuda a entender os próprios códigos e os de outros programadores. Análise coletada por e hospedada no G2.com.

Não funciona, mas se você seguir certos parâmetros ou padrões da programação, pode apresentar falhas. Análise coletada por e hospedada no G2.com.