phpDocumentor Reseñas y Detalles del Producto

- Facilidad de uso

- Generación directa de documentación a partir del código y visibilidad de comentarios de origen

- Conexión directa con la jerarquía de clases/espacios de nombres

- He encontrado que la función de generación de UML es bastante útil ya que usamos herramientas de modelado

- Configuración relativamente fácil incluso para proyectos heredados y soporte inmediato a través de PHARs (¡genial!)

- Me gusta el hecho de que respaldes tu código generando tus propios documentos con PHPDocumentor Reseña recopilada por y alojada en G2.com.

He encontrado un poco difícil controlar cómo se organizan las cosas en el resultado final. Por ejemplo, el orden personalizado de clases/espacios de nombres sería genial. Reseña recopilada por y alojada en G2.com.

La facilidad que la herramienta me propuso para generar la documentación directamente desde el código fuente de PHP, dejando mi proyecto más robusto y autoral, utilizando la herramienta javadoc con la que puedo añadir comentarios relevantes y descartar documentación repetitiva, formando una única documentación en varios formatos, con un gran objetivo para mí de proporcionar todas las herramientas y recursos necesarios para escribir documentación efectiva y completa con el menor esfuerzo posible. Tener un sistema de plantillas flexible que permite cambiar la salida de diferentes maneras y con varios modelos, marcos, arquitecturas enchufables, como WordPress o PyroCms, entre otros. Reseña recopilada por y alojada en G2.com.

No hubo cosas negativas durante mi uso. El software tiene funcionalidades con funciones que aportan mucho a la organización. Reseña recopilada por y alojada en G2.com.

Comencé a usar phpDocumentor desde 2010. Y esta herramienta es muy útil para documentar mi biblioteca PHP. Reseña recopilada por y alojada en G2.com.

Para mí, no hubo inconvenientes con phpDocumentor. Pero solo se necesita disciplina para ejecutarlo y actualizar la documentación del código. Reseña recopilada por y alojada en G2.com.

phpDocumentor es una herramienta y formato de documentación de código muy popular para PHP. Reseña recopilada por y alojada en G2.com.

Una de las mayores molestias de PhpDocumentor era intentar escribir documentación al estilo DocBook para una parte del manual, y documentación de docblock para otra parte. Reseña recopilada por y alojada en G2.com.

Esto es útil porque podemos navegar por ellos más rápido que por los archivos de código, y obtener una documentación muy buena que se puede entregar a todos los desarrolladores del equipo, proveedores de servicios externos o nuevas personas en tu equipo sin mucho trabajo adicional. Reseña recopilada por y alojada en G2.com.

Está casi obsoleto.. Ya no hay un desarrollo o mejora significativa Reseña recopilada por y alojada en G2.com.

La facilidad de la interfaz de usuario y el contenido en general es muy informativo. Reseña recopilada por y alojada en G2.com.

Junto con los temas, debería haber más ejemplos. Reseña recopilada por y alojada en G2.com.

Sintaxis fácil

Compatible con IDEs

Incorporado en el código Reseña recopilada por y alojada en G2.com.

No hay soporte para parámetros con matrices tipadas anidadas ni para matrices de clave-valor. Reseña recopilada por y alojada en G2.com.

Generador automático de comentarios. Los comentarios tienen la estructura correcta. Reseña recopilada por y alojada en G2.com.

Los comentarios en casos muy raros necesitan corrección. Reseña recopilada por y alojada en G2.com.

Realmente me gusta su funcionalidad en sí misma, es una herramienta que nos permite auto-documentar el código que hemos escrito en el lenguaje PHP y esto se hace automáticamente utilizando el código fuente. Me gusta mucho que al hacer uso de una herramienta como esta para todo el código que programamos, nos permite tener una especie de plantilla de documentación que tienen nuestros códigos y poder entender más fácilmente lo que está programado y qué funciones son las que se encuentran en cada sección. Me gusta mucho que usar esta herramienta nos permite continuar fácilmente el código dejado por algún otro programador o que algún colaborador continúe fácilmente el código creado por nosotros ya que nos permite tener una buena documentación. También me gusta mucho que nos permite migrar todo el código a un archivo HTML con un gran grado de detalle de todo, desde comentarios hasta funciones, variables, entre otras cosas. Reseña recopilada por y alojada en G2.com.

Básicamente, el único aspecto negativo es la pequeña comunidad que tiene y que quizás no es una herramienta que aún ha recibido el reconocimiento que merece, pero la verdad es que es una herramienta que obliga al programador a tener una buena práctica de codificación. Reseña recopilada por y alojada en G2.com.

- Php documentor tiene múltiples plantillas para que la documentación sea más agradable a la vista del usuario.

- Php documentor es capaz de interpretar la información para crear gráficos e informes.

- Php documentor tiene una sección importante para reportar todos los `TODO` que se encuentran en el código.

- Php documentor crea toda la wiki para todas las funciones; incluso el constructor y las constantes para cada clase. Reseña recopilada por y alojada en G2.com.

- A pesar de que tiene múltiples plantillas, parece que las plantillas son demasiado antiguas para las herramientas HTML actuales.

- La instalación no es fácil de realizar. Reseña recopilada por y alojada en G2.com.