Configurar proyecto en Subversion para completar PHPDocumentor
In: php
7 jul 2010
Una de las partes importantes de un proyecto es la documentación, y me refiero a la documentación técnica y no a los manuales de usuario. De cara a nuevos proyectos, al principio se puede plantear la opción de utilizar PHPDocumentor para hacer la documentación de los ficheros de una manera estándar, y con la potencia que da para http://es.wikipedia.org/wiki/PhpDocumentor de la aplicación. Todo y eso, sigue habiendo el problema que la acción de documentar es muy tedioso para los desarrolladores y nunca apetece dedicar tiempo.
Su pueden configurar los proyectos que estén en un Subversion, para que en cada commit, el repositorio modifique valores dentro de las cabeceras de PHPDocumentor que hay en el código de los ficheros modificados. Esto solamente funciona en archivos PHP (con extensiones como .php o .phtml), y requieren tener una cabecera similar a la siguiente:
/** * * @author $Author$ * @category * @package * @subpackage * @version $Id$ * @since 0 */ /** * * @author $Author$ * @category * @package * @subpackage * @version $Rev$ * @since 0 */
Estos ficheros hay que añadirles una propiedad de Subversion: svn-keywords. El valor que necesita esta propiedad es:
Author Date Rev IdAsí, Subversion buscará los campos de la cabecera que puede rellenar, y introducirá los valores que pertoquen, según el commit. En las siguientes modificaciones, irá actualizando los valores si es que se han realizado cambios en el fichero.
Entradas relacionadas:
- Tags: documentación, php, phpdocumentor, subversion, svn:keywords

1 Comentario en Configurar proyecto en Subversion para completar PHPDocumentor
Guía para crear documentación con PHPDocumentor | Otro Blog Más
16 agosto 2010 a las 08:12
[...] una entrada anterior se mostró como configurar un proyecto en Subversion para completar el PHPDocumentor, pero no se entró en muchos detalles del PHPDocumentor. Esta guía pretende adentrarse un poco [...]