Algorítmica y Programación

Estándares de calidad en el diseño de algoritmos y construcción de programas

Trayecto I fase I
Prof. Marilen Campos

Introducción a los estándares de calidad

Todos los tipos de software a ser desarrollados requieren un control de calidad,
sea software de sistemas (Son programas que sirven a otros programas en el trabajo de
desarrollo como compiladores, editores), ingeniería y científico (es software que posee
un amplio manejo numérico usado en biología, astronomía, CAD), computación
personal (software comercial de uso local como procesadores de texto, hojas
electrónicas, navegadores web, calendarios, agendas, recetarios, ), inteligencia artificial
(software de procesamiento especial sistemas expertos, sistemas basados en el
conocimiento, algoritmos no numéricos).

Hoy día hay muchos programadores pero no todos desarrollan sus programas
con calidad, a este tipo de productos se les llama software basura, algunos ni cuentan
con un respaldo del programador, o simplemente no tiene un soporte de calidad que se
adapte al usuario.

Por eso se presentan dos de los más valiosos controles de calidad, como son la
eficiencia y la eficacia. La ingeniería del software pretende utilizar los recursos
computacionales de tal manera que se produzcan soluciones eficientes y eficaces a los
problemas informáticos, el éxito de un proyecto.

El significado de calidad puede adquirir múltiples interpretaciones, ya que todo

dependerá del nivel de satisfacción o conformidad del cliente. Sin embargo, las
calidades el resultado de un esfuerzo arduo, se trabaja de forma eficaz para poder
satisfacer el deseo del consumidor.
El glosario de estándares de computación IEEE Std. 610 – 1991, define la calidad del
software como “el grado con el que un sistema, componente o proceso cumple los
requerimientos especificados y las necesidades o expectativas del cliente o usuario”
Los estándares definen un conjunto de criterios que guían la forma en que se aplican
procedimientos y metodologías al software desarrollado, la certificación de calidad
permite una valoración independiente de la organización, donde se demuestra la
capacidad de desarrollar productos y servicios de calidad.

Estandarización

Significa que los símbolos convencionales se usan en todos los diagramas de flujo para
prescribir el sistema y que en la documentación se usen formas estandarizadas. Aún
cuando las normas de documentación varían de una instalación a otra, es esencial que
dentro de una organización, se utilice un solo método. El uso de procedimientos y
documentación estandarizada proporciona la base de una comunicación clara y rápida,
adiestramiento menos costoso del personal de sistemas, reducción de costos de
almacenamiento, y otros.

Ventajas De La Estandarización

 Ayuda al entrenamiento del nuevo personal dentro y fuera de la organización de

Sistemas.
 Es útil para cualquiera que tenga la responsabilidad del mantenimiento de los
sistemas.
 Ayuda a los analistas y diseñadores de sistemas en el trabajo de integración de
sistemas.
 Asegura que el sistema opere correctamente.
 Se utilizan eficientemente los recursos que se dispongan.


Normalización

 Asegúrese de que los estándares sean completos, actualizados, documentados y

legibles.
 Auditar permanentemente para que se cumplan los estándares.
 Evaluar si los estándares establecidos son los requeridos y hacer los cambios
necesarios para que dichos estándares sean los apropiados.

Formas y técnicas de documentar algoritmos y programas

Una vez diseñado y bien estructurado un algoritmo, la siguiente actividad a desarrollar,
sumamente importante en programación, es producir programas bien documentados,
para que se cumplan los objetivos básicos, que los programas sean legibles,
comprensibles y fácilmente modificables.
La documentación
Un programa de computadora necesita siempre de una documentación que permita a los
usuarios aprender a utilizarlos y mantenerlo, la documentación del programa se puede
concretar a manual del usuario y manual de mantenimiento.
  Manual de usuario: describe paso a paso la manera cómo funciona el
programa, con el fin de que el usuario obtenga el resultado deseado.
La documentación de usuario es un instrumento muy importante. Una buena
documentación de usuario hará al programa más accesible.

 Manual de mantenimiento
El manual de mantenimiento es la documentación requerida para mantener un
programa durante su ciclo de vida. Se divide en dos categorías, documentación
interna y documentación externa.

Documentación interna

Esta documentación cubre los aspectos del programa relativos a la sintaxis de lenguaje.
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 separar módulos.
 Comentarios significativos.

Documentación externa

Documentación ajena al programa fuente, que se suele incluir en un manual que

acompaña al programa. Esta documentación debe incluir:

 Listado actual del programa fuente.

 Especificación del programa.
 Diagrama de estructura que representa la organización jerárquica de los módulos
que comprenden el programa.
 Explicaciones de fórmulas complejas.
 Especificación de los datos a procesar.
  Formatos de pantallas utilizados para interactuar con los usuarios.
 Cualquier indicación especial que pueda servir a los programadores que deben
mantener el programa.

Reglas de documentación

Un programa bien documentado es aquel que otras personas pueden leer, usar y
modificar. Existe muchos tipos de documentación y con frecuencia los temas a incluir
dependen del programa. A continuación, señalamos algunas características esenciales de
documentación de un programa.

Un comentario de cabecera para el programa que incluye:

 Descripción del programa.

 Autor y fecha.
  Descripción de la entrada y salida del programa.
 Descripción de cómo utilizar el programa.
 Hipótesis sobre tipos de datos esperados.
 Breve descripción de los algoritmos globales y estructurados de datos.
 Descripción de las variables importantes.

El manual de usuario debe contener los siguientes puntos.

 Ordenes necesarias para cargar el programa en memoria desde el

almacenamiento 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.

ELABORACIÓN MANUAL DE USUARIO

Objetivos
 Que el usuario conozca cómo preparar los datos de entrada.
 Que el usuario aprenda a obtener los resultados y los datos de salida.
 Servir como manual de aprendizaje.
 Servir como manual de referencia.
 Definir las funciones que debe realizar el usuario.
 Informar al usuario de la respuesta a cada mensaje de error.

PASOS A SEGUIR PARA DEFINIR COMO DESARROLLAR EL MANUAL

DE USUARIO
 Identificar los usuarios del sistema: personal que se relacionará con el sistema.
 Definir los diferentes tipos de usuarios: se presentan los diferentes tipos de
usuarios que usarían el sistema. Ejemplo: usuarios directos, indirectos.
 Definir los módulos en que cada usuario participará: Se describen los módulos o
procesos que se ejecutarán por cada usuario en forma narrativa breve y clara.

Importancia Del Manual De Usuario

El Manual de Usuario facilita el conocimiento de:
 Los documentos a los que se puede dar entrada por computadora.
 Los formatos de los documentos.
 Las operaciones que utiliza de entrada y salida de los datos.
 El orden del tratamiento de la computadora con los datos introducidos.
 El momento en que se debe solicitar una operación deseada.
 Los resultados de las operaciones realizadas a partir de los datos introducidos.
Al elaborar el Manual de Usuario, hay que tener en cuenta a quién va dirigido
es decir, el manual puede ser manejado desde el director de la empresa hasta el
introductor de datos. Por consiguiente, debe redactarse de forma clara y sencilla
para que lo entienda cualquier tipo de usuario.

Técnicas De Escritura Y Pruebas De Algoritmos Y Programas

Diagramas de Flujo se basan en la utilización de diversos símbolos para

representar operaciones específicas. Se les llama diagramas de flujo
porque los símbolos utilizados se conectan por medio de flechas para
indicar la secuencia de operación.

Pseudocódigo: es una descripción de un algoritmo de programación

informático de alto nivel compacto e informal que utiliza las
convenciones estructurales de un lenguaje de programación verdadero,
pero que está diseñado para la lectura humana en lugar de la lectura en
máquina, y con independencia de cualquier otro lenguaje de
programación.

Lenguaje natural: es el lenguaje hablado o escrito por humanos para

propósitos generales de comunicación. Son aquellas lenguas que han
sido generadas espontáneamente en un grupo de hablantes con propósito
de comunicarse, a diferencia de otras lenguas, los lenguajes de
programación o los lenguajes usados en el estudio de la lógica normal,
especialmente la lógica matemática.