|
Lo mas destacado |
|
|
SISTEMA DE CREACION DE DOCUMENTACION - DOCBOOK
| La documentación en el ámbito de software juega un papel importantísimo como complemento indispensable de los programas informáticos.
Un sistema o software pobremente documentado carece de valor aunque haya funcionado bien en alguna ocasión. En el caso de programas pequeños y poco importantes que sólo se utilizan durante un corto periodo de tiempo, unos cuantos comentarios en el código podrían ser suficientes. No obstante, la mayoría de los programas cuya única documentación es el código no tienen aceptación y es imposible mantenerlos. Dedicar un poco de esfuerzo a la documentación, incluso dentro de los límites de un pequeño proyecto, constituye una muy buena práctica.
Aprender a documentar software es una tarea complicada y exige un criterio de ingeniería maduro. Documentar escuetamente es un erigual de perjudicial: si escribe documentaciones extensas, éstas atosigarán al lector y constituirá. Leer mas.... |
|
|
