Documento Final
“
En cuanto al documento obtenido, el equipo no estaba enterado de que debía contar con un total de 80 páginas como mínimo, nos dimos cuenta hasta el momento en que el profesor lo mencionó a la hora del examen… nuestro documento final consta de alrededor de 75 páginas y lo hicimos lo mejor que pudimos, creemos que tiene un formato aceptable así que esperamos que nuestro profesor sea flexible en este aspecto.
”
Documento de requerimientos
Especificación de requisitos de software
Documentación y mantenimiento.
Documentación
La documentación de un producto software debe servir para enseñar a los usuarios a utilizarlo y ayudar a los programadores a desarrollarlo y mantenerlo y se debe realizar utilizando técnicas estructuradas como diagramas de flujo, algoritmos, diagramas nassi-schneiderman y seudocódigo. Se divide en dos:
Manual de usuario:
Es el que va a decir al usuario la manera de usar el software y qué hacer si se tienen problemas con éste. Debe contar con cuatro secciones:
1. Descripción funcional
– breve descripción de los servicios que proporciona el sistema
2. Instalación
– pasos a seguir para poner el sistema en operación
3. Utilización básica (tutorial)
– cómo comenzar a trabajar con el programa
– funciones más utilizadas y errores comunes
4. Manual de referencia
– descripción detallada de todas las funciones del sistema
– listado de todas las condiciones de error con sus posibles causas y procedimientos de recuperación
Documentación para los programadores:
Servirá a los programadores para el desarrollo y mantenimiento del sistema, por lo tanto debe facilitar la tarea de comprender qué es lo que hace el programa y por qué lo hace, y su buena realización es fundamental a la hora de extender o reparar el programa, ya que todos los programas contienen errores y sufren modificaciones a lo largo de su vida.
Esta documentación se compone de:
• Documentación interna (incluida en el código del programa)
– Comentarios en el código del programa, que expliquen cada elemento del código
– Estructura y estilo del código: facilita su lectura y comprensión (tabulación, separación entre secciones de código, identificadores auto explicativos, etc.).
• Documentación externa (no incluida en el código)
– Especificación: qué hace el programa y cómo lo hace
– Estructura: diagrama de clases, interfaces de las clases
– Descripción de la interfaz con el usuario
– Listado completo y actualizado del programa
– Historial de cambios (en ocasiones se incluye como documentación interna), incluye todo el historial de cambios realizados en el sistema para justificarlos y no realizar los mismos errores, cada cambio debe incluir fecha, razón del cambio, método afectado, y descripción del cambio.
– Formato de los ficheros utilizados para intercambio de información (en el caso de que les haya)
Mantenimiento
El mantenimiento de un producto de software es efectuado rutinariamente a lo largo de su vida para reparar defectos (mantenimiento correctivo), adaptarlo a los cambios en su entorno operativo o extender y/o modificar su funcionalidad.
Mantenimiento correctivo:
Comienza tras la detección de un error y su corrección podría requerir revisar todas las fases del desarrollo de software, pero si el proceso se realizó correctamente, la corrección sólo se realizará en la fase de codificación., Entonces se tendría que pasar al proceso de depuración del código, que consiste en reproducir el error, diagnosticar la causa, corregir el error y verificar la corrección y, una vez que se ha realizado el cambio, actualizar la documentación externa.
Punto de Venta Kiosko. Equipo 1 