Programa de computadora

1

3

Leer aEscribir "Indique el segundo sumando"Leer bc=a+bEscribir "El resultado es: ";cFinalT R A Z AComentario ValoresLeemos a 4Leemos b

5

Calculamos c=a+b 9Escribimos c 9La función principal que posee realizar la traza de un algoritmo es la de comprobar queéste funciona correctamente o para realizar la etapa de depuración en la que se intentacorregir errores, simplificar el algoritmo al máximo e incrementar su eficacia yvelocidad.

F

ORMAS Y TÉCNICAS DE DOCUMENTAR ALGORITMOS Y PROGRAMAS

La DocumentaciónUn programa de computadora necesita siempre de una documentación que permita alos usuarios aprender a utilizarlos y mantenerlo, la documentación del programa sepuede concretar a manual del usuario y manual de mantenimiento.Manual del usuario

1

4

La documentación de un programa suele producirse con dos propósitos, el primeroseria explicar las funciones del software y describir el modo de utilizarlas estas estándiseñadas para ser leídas por el usuario del programa y la segunda describir elsoftware en si para poder mantener el sistema en una etapa posterior de su ciclo devida.La documentación de usuario es un instrumento muy importante. Una buenadocumentación de usuario hará al programa más accesible.El manual de usuario debe contener los siguientes puntos.



Ordenes necesarias para cargar el programa en memoria desde elalmacenamiento secundario y comenzar su funcionamiento.



Nombres de los archivos externos a los que accede el programa.



Formato de todos los mensajes de error o informes.



Opciones en el funcionamiento del programa.



Descripción detallada de la función realizada por el programa.



Descripción detallada de cualquier salida producida por el programa.Manual de mantenimientoEl manual de mantenimiento es la documentación requerida para mantener unprograma durante su ciclo de vida. Se divide en dos categorías, documentación internay documentación externa.Documentación internaEsta documentación cubre los aspectos del programa relativos a la sintaxis delenguaje. Esta documentación está contenida en los comentarios entre llaves,paréntesis o asteriscos. Algunos temas a considerar son:



Cabecera de programa (breve descripción del programa)



Nombres significativos para describir identificadores.



Comentarios relativos a la función del programa.



Claridad de estilo y formato, líneas en blanco para separa módulos.

1

5



Comentarios significativos.Documentación externaDocumentación ajena al programa fuente, que se suele incluir en un manual queacompaña al programa. Esta documentación debe incluir:

...