Estándares de Codificación

Descargar como doc, pdf o txt
Descargar como doc, pdf o txt
Está en la página 1de 2

ACS - IS

PLAN DE CONVENCIONES
Y ESTNDARES DE CODIFICACIN
1. Generalidades
La transicin desde un diseo detallado a la codificacin, comienza cuando el
desarrollador escribe los mdulos que compilen en el lenguaje de programacin
seleccionado.
Esta transicin es obvia cuando existe un diseo que ha sido
confeccionado en forma detallada, lo que facilita la programacin.
Un cdigo fuente completo debe reflejar un estilo armonioso, como si un nico
programador hubiera escrito todo el cdigo de una sola vez.
La legibilidad del cdigo fuente repercute directamente en lo bien que un
programador comprende un sistema de software. La mantencin del cdigo es la facilidad
con que el sistema de software puede modificarse para aadirle nuevas caractersticas,
modificar las ya existentes, depurar errores, o mejorar el rendimiento.
Aunque la legibilidad y la mantencin son el resultado de muchos factores, una
faceta del desarrollo de software en la que todos los programadores influyen
especialmente es en la tcnica de codificacin.
El cdigo debe estar basado en los principios de:
-

Documentacin del cdigo


Incluir una cabecera para cada mdulo, procedimiento y/o funcin
Utilizar nombres significativos y no ambiguos
Evitar la mezcla de tipos de datos
Evitar variables temporales
Usar parntesis en las expresiones
Escribir cdigo legible
Adjuntar comentarios tiles y claros
Ser consistente en el uso del lenguaje de programacin
Crear mdulos cortos, basados en criterios de unicidad y reutilizacin
Crear el cdigo en forma simple

Plan de Convenciones
y Estndares de Codificacin

V1.0 15-05-2015

Pgina 1

ACS - IS

2. Documentacin Interna
Existen dos tipos de documentacin de software: interna y externa. La
documentacin externa como por ejemplo las especificaciones, los archivos de ayuda y
los documentos de diseo, se debe mantener fuera del cdigo fuente. La documentacin
interna est formada por los comentarios que el equipo de desarrollo escribe dentro del
cdigo fuente durante la fase de implementacin.
A continuacin se dan a conocer las normas y convenciones para mantener un
cdigo fuente estndar dentro del Departamento de Ingeniera de Sistemas del Hospital
Clnico Herminda Martin de Chilln.

Plan de Convenciones
y Estndares de Codificacin

V1.0 15-05-2015

Pgina 2

También podría gustarte