Geschätzte Lesezeit : 5 min · Veröffentlicht
Provenienz und Umfang schaffen
Beschreiben Sie den Produzenten, das Sammelverfahren, den Zeitraum und die geografische oder thematische Abdeckung. Unterscheiden Sie Extraktions-, Aktualisierungs- und Messdaten. Eine heute veröffentlichte Datei kann eine frühere Messung beschreiben. Die Veröffentlichung ändert ihr Bezugsjahr nicht.
Geben Sie fehlende Bereiche und ungefähre Werte an, in denen die Quelle sie identifiziert. Füllen Sie keine Lücke mit einer unbekannten Schätzung. Die Dokumentations-Leitfaden von data.gouv.fr richten sich an den Produktionskontext, die Struktur und mögliche Inkonsistenzen.
Geben Sie ein Wörterbuch und ein Beispiel an
Erklären Sie jedes Feld, jede Einheit, jeden Typ, jeden fehlenden Wert und Referenzcode. Geben Sie ein kleines lesbares Beispiel an, das mit dem vollständigen Datensatz übereinstimmt. Wobei Bezeichner Tabellen, Dokumentbeziehungen und möglicherweise nicht übereinstimmende Zeilen verbinden.
Entitäten von ihren Etiketten unterscheiden. Eine Gemeinde kann mehrere Postleitzahlen und ein Produkt mehrere Varianten haben. Die Dokumentation sollte helfen, irreführende Aggregation oder Deduplizierung zu verhindern, die eine nützliche Beziehung entfernt.
Bei Geodaten Referenzsystem und Koordinatenreihenfolge dokumentieren, nicht nur das Format. RFC 7946 definiert GeoJSON mit WGS 84 und Dezimalgrad; die ersten beiden Positionswerte sind Längen- und Breitengrad. Im fiktiven Beispiel darf Point [2.35,48.86] nicht zu [48.86,2.35] werden. Beide Arrays sind lesbares JSON mit plausiblen Werten; reine Syntaxprüfung erkennt die Vertauschung nicht.
Ein nicht lokalisiertes Objekt von einem bekannten Punkt unterscheiden. Eine nicht lokalisierte GeoJSON Feature darf geometry: null haben; das ist weder ein Point mit null-Koordinaten noch der Ersatz unbekannter Daten durch die reale Position [0,0]. Auch die Bedeutung beschreiben: beobachteter Eingang, geokodierte Adresse oder berechneter Mittelpunkt, jeweils mit Herkunft und Datum. Zusätzliche Dezimalstellen machen eine Schätzung nicht sicherer.
Scrollen Sie die Tabelle horizontal, um alle Spalten zu lesen. Mit der Tastatur fokussieren Sie den Tabellenbereich und verwenden die Pfeiltasten.
| Fall | Bedeutung | Sinnvolle Prüfung |
|---|---|---|
| Point · coordinates: [2.35,48.86] | Längengrad 2.35; Breitengrad 48.86 | Mit benannten Quellfeldern vergleichen |
| Point · coordinates: [48.86,2.35] | Plausible Zahlen, im Beispiel vertauscht | Bedeutung prüfen; Syntax reicht nicht |
| Feature · geometry: null | Nicht lokalisiertes Objekt; Strukturfragment | Fehlenden Wert dokumentieren, keinen Punkt erfinden |
| Position [0,0] | Existierende Koordinaten, kein Fehlen | Nicht automatisch für unbekannte Werte einsetzen |
Überprüfen Sie die Veröffentlichung und Wiederverwendung
Identifizieren Sie die Quellenwiederverwendungsbedingungen und die Attributionsinformationen, um sie aufzubewahren. Lassen Sie die entsprechenden Prüfer die Veröffentlichungsrechte und mögliche personenbezogene Daten vor der Veröffentlichung beurteilen. Eine an anderer Stelle sichtbare Adresse macht nicht automatisch jede Kopie für die Veröffentlichung geeignet.
Testen Sie Downloads ohne interne Tools oder spezielle Konten, wenn der öffentliche Zugriff versprochen wird. Überprüfen Sie Format, Codierung und Integrität. Geben Sie eine Versionsreferenz oder eine Prüfsumme an, damit Feedback an die heruntergeladene Datei gebunden werden kann.
Versionen und Korrekturen pflegen
Wählen Sie eine realistische Überprüfungshäufigkeit und einen Kontakt für Probleme. Beschreiben Sie hinzugefügte, entfernte oder neu definierte Felder, wenn sich Schemas ändern. Unterscheiden Sie Korrekturen von neuen Messungen, um falsche Änderungen in einer Zeitreihe zu vermeiden.
Bewahren Sie nützliche Versionen und Notizen mit einer klaren Ersatzrichtlinie auf. Die Veröffentlichungsdokumentation sollte eine andere Person die Extraktion reproduzieren oder ihre Grenzen verstehen. Ein Download-Zähler ersetzt nicht die Dokumentationsqualität.
Primärdokumentation: data.gouv.fr : Bien documenter un jeu de données.
Unterscheiden Sie Datensatz und Distributionen. Eine CSV- und JSON-Datei können denselben Datensatz in zwei Formaten darstellen; zählen Sie sie nicht automatisch als unabhängige Messungen. DCAT beschreibt eine Distribution als konkrete Darstellung eines Datensatzes. Vergleichen Sie dennoch Abdeckung, Präzision, Felder und Version: Zwei Distributionen sind nicht unbedingt verlustfrei gleichwertig.
Ergänzen Sie Versionskennung und Änderungshistorie. Eine Adresse für die „neueste Version“ kann stabil bleiben, doch die tatsächlich verwendete Version muss identifizierbar sein. Trennen Sie auch Korrektur und neue Beobachtung: Die Messung eines neuen Monats korrigiert nicht allein dadurch den vorherigen. Erläutern Sie den Zusammenhang zwischen Versionen und Reihen vor einem Zahlenvergleich.
Scrollen Sie die Tabelle horizontal, um alle Spalten zu lesen. Mit der Tastatur fokussieren Sie den Tabellenbereich und verwenden die Pfeiltasten.
| Dokumentationselement | Was es unterscheidet | Nützliche Prüfung |
|---|---|---|
| Datensatz | Beschriebenes Thema, Umfang und Beobachtungen. | Seine Identität ist unabhängig vom Dateiformat verständlich. |
| CSV- oder JSON-Distribution | Eine konkrete Darstellung des Datensatzes. | Felder, Präzision und Abdeckung vor einer Gleichwertigkeitsannahme vergleichen. |
| Identifizierte Version | Einen bestimmten Zustand und seine Änderungshistorie. | Zitierte Version wiederfinden, auch wenn eine aktuelle Adresse aktualisiert wurde. |
| Korrektur oder neuer Zeitraum | Überarbeiteten Wert oder andere Beobachtung. | Einen neuen Monat nicht als automatische Korrektur des vorherigen darstellen. |
- W3C DCAT 3 : Distributionen
Abgerufen am 22. Oktober 2026; Datensätze, Darstellungen und mögliche Unterschiede im Informationsgehalt.
- W3C : Daten im Web und Versionierung
Abgerufen am 22. Oktober 2026; Versionskennungen, Historie und Beobachtungen verschiedener Zeiträume.
Referenzdokumente
- W3C – Daten zu den Best Practices im Internet · Quelle eingesehen
- IETF : GeoJSON RFC 7946 · Quelle eingesehen
- data.gouv.fr : Bien documenter un jeu de données
Inhalt aktualisiert
Dokumentierte Grundlagen zu diesem Thema
| Referenz | Wert oder Syntax | Geltungsbereich |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | Felder mit Kommas, Anführungszeichen oder Zeilenumbrüchen werden eingefasst; innere Anführungszeichen verdoppelt. |
| RFC 8259 · JSON | application/json · UTF-8 | Standard-JSON erlaubt weder Kommentare noch abschließende Kommas; Zeichenfolgen nutzen doppelte Anführungszeichen. |
Die Daten geben die Prüfung der Quellen an. Diese Hinweise sind weder ein Website-Audit noch eine umfassende Konformitätserklärung.
