3.3 Documentación

En esta sección puedes consultar lo relacionado a la documentación necesaria para la apertura de un conjunto de datos en formato abierto.

Asegurar que los Datos Abiertos incluyan metadatos consistentes, diccionarios, catálogos y una licencia abierta, facilita el entendimiento del origen, tratamiento y significado de los conjuntos y recursos de datos. Es por esto, que se deberá de publicar de manera complementaria toda la documentación necesaria para entender el contexto de los datos.

Metadatos

Se deberá crear o utilizar un estándar de metadatos con el objetivo de mejorar la interoperabilidad de catálogos de datos existentes, con adiciones para incrementar la utilidad de los datos para los usuarios. Alguno de los campos mínimos que se deberán incluir son los siguientes:

  • Identificador: identificador único ej. “adquisiciones”.

  • Título: Título descriptivo ej. “Listado de diputados de la LXII legislatura”.

  • Descripción: Una explicación de los datos.

  • Palabras clave: Lista de términos clave separados por coma.

  • Modificación: Fecha y hora de la última modificación .ej. “2021-05-27T01:42:05-05:00

  • Responsable: Nombre de la persona de contacto.

  • Contacto: Correo electrónico de contacto.

  • Periodicidad: Frecuencia con la cual el conjunto de datos será publicado o actualizado ej. “mensualmente”.

  • URL: Dirección electrónica (enlace) para la descarga del recurso.

Ejemplo de metadatos

Diccionarios

Además de los metadatos, es necesario que cada conjunto se acompañe de un diccionario de datos, este es un repositorio centralizado de información sobre datos tales como significado, relación con otros datos, origen, uso y formato. El objetivo es que los usuarios comprendan el origen, metodologías, significado y potencial de los datos, de ser posible privilegiando su publicación en formato CSV.

Ejemplo de diccionario de datos

Licencia

Se deberá escoger una licencia que permita el uso, reúso y redistribución. Los datos no deberán estar sujetos a ningún derecho de autor, patente, marca registrada o regulación de secreto comercial. Se pueden permitir restricciones razonables de privacidad, seguridad y privilegios.

Ejemplo de licencia abierta

Última actualización