Niveles de Documentación de un proyecto

Existen 3 niveles de documentación de un proyecto.

1) La documentación del proyecto es una herramienta para hacer el proyecto
Una herramienta útil que te ayuda a conseguir tu fin. Algo que haces ANTES de tirar una línea de código para tener claro que hacer. Y, sobretodo, documentos que te ayudan realmente. Si no tienes claro para que vale un documento, no lo usas hasta entenderlo o necesitarlo. Nada de hacer documentación por hacer.
Conforme vas haciendo más proyectos vas viendo que documentos son más necesarios y de cuales puedes prescindir.

2) La documentación del proyecto NO es una herramienta útil.
La documentación es algo que te exige alguien (jefe de proyecto, cliente, auditoría interna, ISO) que hagas. No entiendes muy bien para que vale, no entiendes muy bien para sirve. Primero haces el programa y luego si eso, si tienes tiempo documentas (normalmente suele acabar en un no-tengo-tiempo-para-documentar, o-documento-o-programo).
Sueles acabar reutilizando documentos antiguos cambiando el texto y realmente tienes un problema grave en tus conocimientos. El resultado es Caos.

3) No documentas el proyecto
O bien porque no tuviste tiempo o bien no sabes como documentar el proyecto. El resultado es el mismo: Caos.

El documento más importante es la especificación de requisitos, muchas veces inexistente. Aunque hay que reconocer que a veces es difícil de conseguir.

Leave a Reply

*
To prove you're a person (not a spam script), type the security word shown in the picture.
Anti-Spam Image