“El objetivo de la documentación es comprender, no documentar”.
Lo que se tiene que lograr a la hora de documentar es tratar de entender el problema, no importa que herramienta se utiliza, lo importante es la comprensión. La documentación es un medio para llegar a tiempo a nuestro proyecto.
El gran problema en la ingeniería de software es que la documentación se deja siempre de lado, o no se le da la importancia necesaria. Cuando se debe documentar? Siempre! Lo antes posible!
Al documentar debemos evitar confusiones, si es necesario debemos realizar distintos tipos de documentos para las diferentes tipos de usuario de la aplicación.
Los documentos deben ser:
- Sencillos.
- Comprensibles.
- Utilizar párrafos cortos.
- Organizar la información con secciones y subsecciones.
