27.7.2.

- ESTÁNDARES DE DOCUMENTACIÓN

Son documentos importantes ya que es la única forma tangible de

representar al software y sus procesos. Los estandarizados tienen una
estructura , apariencia y calidad consistente, lo cual son mas fáciles de leer y
comprender.

Existen tres tipos de estándares de documentación:

1. Estándares del proceso de documentación .- Define el proceso a

seguir para la deducción del documento.
2. Estándares del proceso del documento .- Gobiernan la escritura y
presentación de los documentos.
3. Estándares para el intercambio de documentos .- Aseguran que
todas las copias electrónicas de los documentos sean compatibles.

Implica definir los procedimientos del desarrollo del documento y las

herramientas utilizadas. También definen procedimientos de comprobación y
refinamiento para que sean de alta calidad los documentos.

Deben ser flexibles y se deben de ajustar a todos los tipos de documentos.

Para los documentos de trabajo o memorándum no hay que detallar la
calidad. Los documentos son formales que se utilizan para desarrollos
posteriores o se le entregan a los clientes se adopta un proceso formal de
calidad.

Crear un borrador, comprobarlo, revisarlo y rehacerlo es un proceso iterativo,

esto se continua hasta que se hace un documento de calidad aceptable. esto
dependo del tipo de documento y de los lectores potenciales.

Los estándares se aplican a todos documentos producidos durante el

desarrollo del software. Deben tener un estilo, apariencia y estructura
consistente.

Algunos ejemplos de estándares de documentos a desarrollar son:

1. Estándares de identificación de documentos.- Para los

documentos formales esta definido por el gestor de configuraciones y
los informales por el gestor de proyecto.
2. Estándares de la estructuradle documento.- Se debe definir las
secciones a incluir y especificar las convenciones utilizadas par la
numeración de paginas.
3. Estándares de presentación de documentos.- se define un estilo
propio para los documentos.
4. Estándares para actualizar los documentos.- se debe utilizar una
forma consistente para indicar los cambios en el documento.
Los estándares de intercambio de documentos son importantes y su
utilización permite que los documentos se transfieran electrónicamente esto
causa que se delimite los tipos de letra y los estilos de texto utilizados debido
a los diversos recursos de visualización e impresión.

En la siguiente figura se muestra un modelo de uno de los posibles procesos

de documentación: