POO (Documentacion)

POO (Documentacion)

La documentación técnica en la programación es sumamente importante por las siguientes razones:

Comprensión de un programa : 

La documentación es necesaria para la comprensión de un programa ya que aunque uno mismo sea el que hizo el programa, sistema o aplicación, muchas veces con el tiempo, por aprender nuevas cosas y querer optimizar o simplemente por no recordar lo que hace cierta parte del programa, nos quedamos sin poder hacer nada en el o tardamos en recuperar la idea de como lo hicimos.

Este tipo de cosas hace muy útil la documentación para uno mismo, pero no es el único aspecto en el que es útil. 

Mantenimiento:

El mantenimiento de un programa es posible gracias a la documentación, ya que no siempre el mantenmiento esta pensado en hacerse por la persona que desarrolló el programa o aplicación, sino muchas veces este es realizado por otras personas que utilizan el programa y lo desean optimizar o modificar para sus propios fines.

Profesionalismo:

Además considero que si uno como programador desea darle una buena presentación a su trabajo(además de una interfaz gráfica vistosa) es necesaria una correcta documentación del programa.

Si claro, comentarios normales en un programa ayudan y con eso es suficiente para un mantenimiento y comprensión, pero el uso de herramientas como JAVADOC y DOXYGEN hace de la documentación técnica algo mas sencillo y vistoso para agregarle al programa.