Cuando sea posible, crear la estructura de la base de datos con la descripción de los campos mediante comentarios. Esto permite que el diccionario de datos pueda ser generado de forma automática mediante herramientas o consultas a la base de datos.
- Los comentarios almacenados en el campo COMMENTS, o el que haga sus veces, debe ser en español, siempre que sea posible.
- Los comentarios deben describir breve y claramente el dato que se almacena en el campo.
- No se deben utilizar caracteres especiales en los comentarios.
- No se debe utilizar la letra Ñ o ñ.
- No es necesario describir el tipo de dato que se almacena (Number, Varchar, Etc), esto se obtiene de la estructura de la tabla.
- Para el caso de los campos llave, (Primaria, Foranea, Etc) se recomienda indicar la descripción y característica de la lleva en el comentario. También, describir la relación.
- El campo ESTADO, no necesita ser comentado.
- Si la tabla implementa un campo ESTADO adicional, por necesidad o por funcionalidad, este debe ser comentado y descrito.
- Si el campo es un arreglo, indicar en los comentarios, de manera breve y concisa, los datos que se almacenan.
- Si el campo en un Json, indicar en los comentarios, de manera breve y concisa, los datos que se almacenan.
- Si el campo corresponde a un autonumerico, por favor indicarlo en el comentario.
- Si el campo se obtiene automáticamente de una secuencia, por favor indicarlo en el comentario e incluir el nombre de la misma.