El objetivo de la documentación es comprender, no documentar

Desarrollamos gráficos y escribimos casos de uso, pero no lo hacemos para tener una documentación perfecta, constantemente actualizada del proyecto. ¡No! Nuestro objetivo no es generar papel, nuestro objetivo como programadores es generar el código, un buen código.

Si pudiéramos generar un buen código sin necesidad de diagramas de clases, flujos de datos, etc. lo haríamos. Pero no podemos. Durante el proyecto necesitaremos hacer diagramas y documentos para entender el problema que estamos abordando y para comunicar a otras personas las soluciones que queremos aplicar.

Por eso no se trata de documentar, sino de comprender. Y, en estos términos, la documentación es sólo un medio para llegar al código, no un fin es si misma. Así que, si al final del proyecto está incompleta y desactualizada, pero el código está bien, ¡estupendo! Así es como debe ser.

No hay mejor documentación que un código bien hecho. Nada como el código podrá expresar la funcionalidad del sistema, su arquitectura y sus estrategias.