Publicar datos abiertos comprensibles y documentados

Establecer procedencia y alcance

Describa el productor, el método de recolección, el período de tiempo y la cobertura geográfica o temática. Distinguir las fechas de extracción, actualización y medición. Un archivo publicado hoy puede describir una medida anterior; La publicación no cambia su año de referencia.

Determine las áreas faltantes y los valores aproximados donde la fuente las identifica. No llene un vacío con una estimación no revelada. La guía de documentación de data.gouv.fr aborda el contexto de producción, la estructura y las posibles inconsistencias.

Proporcione un diccionario y un ejemplo

Explique cada campo, unidad, tipo, valor faltante y código de referencia. Proporcione un pequeño ejemplo legible consistente con el conjunto de datos completo. donde los identificadores se unen a las tablas, las relaciones de los documentos y las filas potencialmente incomparables.

distinguir a las entidades de sus etiquetas. Un municipio puede tener varios códigos postales y un producto varias variantes. La documentación debería ayudar a evitar la agregación o deduplicación engañosa que elimine una relación útil.

Consultar publicación y reutilización

Identificar las condiciones de reutilización de la fuente y la información de atribución para retener. Haga que los revisores apropiados evalúen los derechos de publicación y los posibles datos personales antes de la publicación pública. Una dirección visible en otro lugar no hace que todas las copias sean adecuadas para su publicación.

Pruebe las descargas sin herramientas internas ni cuentas especiales cuando se promete acceso público. Comprobar formato, codificación e integridad. Proporcione una referencia de versión o una suma de verificación para que los comentarios puedan vincularse al archivo descargado.

Mantener versiones y correcciones

Elija una frecuencia de revisión realista y un contacto para los problemas. Describa los campos agregados, eliminados o redefinidos cuando cambian los esquemas. Distingue las correcciones de las nuevas mediciones para evitar crear cambios falsos en una serie de tiempo.

Conserve versiones y notas útiles con una política de reemplazo clara. La documentación de publicación debe permitir que otra persona reproduzca la extracción o comprenda sus limitaciones. Un contador de descargas no reemplaza la calidad de la documentación.

Documentación principal: data.gouv.fr — Documentando cuidadosamente un conjunto de datos.