Esta sección esta dedicada a la definición del proceso de documentación de código fuente que se debe implementar en las estructuras de código fuente generado en las aplicaciones de la compañía.

La siguientes estructuras de código fuente que deben ser documentadas:

• Clases
• Métodos de Clases
• Ventanas
• Funciones y Eventos de Ventanas
• Formularios
• Paquetes de base de datos
• Funciones y Procedimientos de bases de datos

Se definen los siguientes tipos de documentación:

• Interna: Utilizada en el código fuente de las aplicaciones de la compañia. Ver Estructuras de Código Fuente. Esta documentación se caracteriza porque está interna en el código fuente y puede ser consultada directamente consultando las estructuras de código o utilizando una aplicación de generación de documentación técnica según el lenguaje de documentación.
• Externa: Utilizada en el código fuente de las aplicaciones de la compañia del proceso de migración. Esta documentación es generada complementaria a la documentación interna. Este proceso ya esta definido en la siguiente sección: Documentación Externa de Microservicios

A continuación se define la Plantilla Base de documentación que debe ser implementada en las Estructuras de Código Fuente de las aplicaciones de la compañía

/**
 
Título
 
Descripción
 
Retorno
 
Acceso
 
Argumentos
 
Modo de Uso
 
Autor
 
Fecha
 
deprecated
 
throws
 
Sección para revisiones y versionamiento
 
Copyright Año ADA, Inc. All rights reserved.
*/

Nombre de la Estructura de Código Fuente que se documentará.

Describe el objetivo de la Estructura de Código Fuente. Esta descripción debe ser clara y concisa.

Describe el valor de salida de un método. No aplica para definiciones de clases.

Describe los parámetro de un método.

Este campo se utiliza para presentar un ejemplo de la forma de invocar o ejecutar la Estructura de Código Fuente.

Indica quién escribió la Estructura de Código Fuente que se refiere el comentario. Si son varias personas se escriben los nombres separados por comas. El nombre del autor debe ser escrito según el correo del usuario de la compañía nombre.apellido@ada.co el cual es otorgado al empleado al ingresar. Si es un autor externo se debe registrar el nombre completo más el correo personal.

Fecha Este campo registra la fecha inicial de creación de la Estructura de Código Fuente

Indica que la Estructura de Código Fuente es antigua y que no se recomienda su uso porque posiblemente desaparecerá en versiones posteriores o será reemplazada.

Sólo aplica para métodos describe las excepciones que pueden ser lanzadas por el método.

Este campo se utiliza para registrar los derechos reservados de la Estructura de Código Fuente se debe diligenciar la columna Año según la vigencia de creación.

←Volver atras