Documentación de proyectos

Llevo un tiempo trabajando en el despliegue de JASIG CAS. Como neófito en aplicaciones web desarrolladas en Java me ha costado bastante comprender cómo se hacen algunas cosas en este entorno. Sin embargo una vez que hemos concluido con éxito el proyecto, debo decir que echo de menos una documentación del proyecto adecuada. La documentación se gestiona mediante un wiki, el problema es que se mezcla información para diferentes versiones del proyecto sin ningún tipo de control. Varios de los errores que he tenido que enfrentar se han producido porque la documentación del wiki hacía referencia a una versión obsoleta.

Anteriormente he trabajado con otros productos de software libre donde la documentación está a un nivel altísimo. Por nombrar dos pondré Django y QT. La documentación del proyecto es muy importante para su éxito en un entorno de software libre evolutivo. Creo que el éxito de las buenas documentaciones viene por evolucionar con el proyecto. ¿Qué buenos mecanismos de gestión de la documentación conoces?

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: