Avis et détails du produit phpDocumentor

- Facilité d'utilisation

- Génération directe de documentation à partir du code et visibilité des commentaires source

- Connexion directe à la hiérarchie des classes/espaces de noms

- J'ai trouvé la fonctionnalité de génération UML assez utile car nous utilisons des outils de modélisation

- Configuration relativement facile même pour les projets hérités et prise en charge via des PHARs (sympa !)

- J'aime le fait que vous souteniez votre code en générant vos propres documents avec PHPDocumentor Avis collecté par et hébergé sur G2.com.

J'ai trouvé un peu difficile de contrôler comment les choses sont organisées dans le résultat final. Par exemple, un classement personnalisé des classes/espaces de noms serait formidable. Avis collecté par et hébergé sur G2.com.

L'installation que l'outil m'a proposée pour générer la documentation directement à partir de la source du code PHP rend mon projet plus robuste et original, en utilisant l'outil javadoc qui me permet d'ajouter des commentaires pertinents et de supprimer la documentation répétitive, formant une documentation unique en plusieurs formats, avec un grand objectif pour moi de fournir tous les outils et ressources nécessaires pour rédiger une documentation efficace et complète avec le moins d'effort possible. Ayant un système de modèles flexible permettant de modifier la sortie de différentes manières et avec divers modèles, cadres, architectures enfichables, tels que WordPress ou PyroCms, entre autres. Avis collecté par et hébergé sur G2.com.

Il n'y avait pas de choses négatives pendant mon utilisation. Le logiciel a des fonctionnalités avec des fonctions qui ajoutent beaucoup à l'organisation. Avis collecté par et hébergé sur G2.com.

Je commence à utiliser phpDocumentor depuis 2010. Et cet outil est très utile pour documenter ma bibliothèque PHP. Avis collecté par et hébergé sur G2.com.

Pour moi, il n'y avait aucun inconvénient avec phpDocumentor. Mais il faut juste de la discipline pour le faire fonctionner afin de mettre à jour la documentation du code. Avis collecté par et hébergé sur G2.com.

Ceci est utile car nous pouvons les parcourir plus rapidement que les fichiers de code, et obtenir une très bonne documentation qui peut être distribuée à tous les développeurs de l'équipe, aux prestataires de services tiers ou aux nouvelles personnes de votre équipe sans beaucoup de travail supplémentaire. Avis collecté par et hébergé sur G2.com.

C'est presque obsolète.. Il n'y a plus de développement ou d'amélioration significative. Avis collecté par et hébergé sur G2.com.

La facilité de l'interface utilisateur et le contenu global est très instructif. Avis collecté par et hébergé sur G2.com.

Avec les sujets, il devrait y avoir plus d'exemples. Avis collecté par et hébergé sur G2.com.

Syntaxe facile

Pris en charge par les IDE

Intégré dans le code Avis collecté par et hébergé sur G2.com.

Pas de support pour les paramètres avec des tableaux typés imbriqués ni pour les tableaux de paires clé-valeur. Avis collecté par et hébergé sur G2.com.

Automate la génération de commentaires. Les commentaires ont la structure correcte. Avis collecté par et hébergé sur G2.com.

Les commentaires, dans de très rares cas, nécessitent une correction. Avis collecté par et hébergé sur G2.com.

J'aime vraiment sa fonctionnalité elle-même, c'est un outil qui nous permet d'auto-documenter le code que nous avons écrit en langage PHP et cela se fait automatiquement en utilisant le code source. J'aime vraiment qu'en utilisant un outil comme celui-ci pour tout le code que nous programmons, cela nous permet d'avoir une sorte de modèle de documentation que nos codes ont et de pouvoir comprendre plus facilement ce qui est programmé et quelles fonctions se trouvent dans chaque section. J'aime vraiment que l'utilisation de cet outil nous permette de continuer facilement le code laissé par un autre programmeur ou qu'un collaborateur continue facilement le code créé par nous puisqu'il nous permet d'avoir une bonne documentation. J'aime aussi beaucoup qu'il nous permette de migrer tout le code vers un fichier HTML avec un grand niveau de détail de tout, des commentaires aux fonctions, variables, entre autres choses. Avis collecté par et hébergé sur G2.com.

Fondamentalement, le seul point négatif est la petite communauté qu'il a et ce n'est peut-être pas un outil qui a encore reçu la reconnaissance qu'il mérite, mais la vérité est que c'est un outil qui oblige le programmeur à avoir une bonne pratique de codage. Avis collecté par et hébergé sur G2.com.

- Php documentor a plusieurs modèles afin d'avoir une documentation plus agréable à la vue de l'utilisateur.

- Php documentor est capable d'interpréter les informations pour créer des graphiques et des rapports.

- Php documentor a une section importante pour signaler tous les `TODO` qui sont placés dans le code.

- Php documentor crée l'ensemble du wiki pour toutes les fonctions, y compris le constructeur et les constantes pour chaque classe. Avis collecté par et hébergé sur G2.com.

- Malgré le fait qu'il ait plusieurs modèles, il semble que les modèles soient trop anciens pour les outils HTML actuels.

- L'installation n'est pas facile à réaliser. Avis collecté par et hébergé sur G2.com.

C'est le maximum puisque, en tant que programmeur et pour les temps d'exécution, il est difficile de commenter le code, cet outil fait l'analyse du code source et génère un fichier suivant les normes de programmation, ce qui aide à comprendre ses propres codes et ceux des autres programmeurs. Avis collecté par et hébergé sur G2.com.

Cela ne fonctionne pas mais vous suivez certains paramètres ou normes de la programmation, cela peut vous donner des échecs. Avis collecté par et hébergé sur G2.com.