Geschatte leestijd : 5 min · Gepubliceerd
Herkomst en reikwijdte vaststellen
Beschrijf producent, verzamelmethode, tijdsperiode en geografische of thematische dekking. Onderscheid extractie, update en meetdata. Een bestand dat vandaag is gepubliceerd, kan een eerdere meting beschrijven; Publicatie verandert niets aan het referentiejaar.
Geef ontbrekende gebieden en geschatte waarden aan waar de bron ze identificeert. Vul een leemte niet met een onbekende schatting. Data.gouv.fr's documentatierichtlijnen behandelt de productiecontext, structuur en mogelijke inconsistenties.
Geef een woordenboek en een voorbeeld
Leg elk veld, een eenheid, type, ontbrekende waarde en referentiecode uit. Geef een klein leesbaar voorbeeld dat consistent is met de volledige dataset. Waar identifiers samenvoegen tabellen, documentrelaties en mogelijk ongeëvenaarde rijen.
onderscheidt entiteiten van hun labels. Een gemeente kan meerdere postcodes en een product meerdere varianten hebben. Documentatie zou misleidende aggregatie of deduplicatie moeten helpen voorkomen die een nuttige relatie verwijdert.
Documenteer bij geodata referentiestelsel en coördinatenvolgorde, niet alleen het formaat. RFC 7946 definieert GeoJSON met WGS 84 en decimale graden; de eerste twee positiewaarden zijn lengtegraad en breedtegraad. In een fictieve oefening mag Point [2.35,48.86] niet [48.86,2.35] worden. Beide arrays zijn leesbaar JSON en de waarden blijven aannemelijk: alleen syntaxcontrole ontdekt deze omwisseling niet.
Onderscheid een niet-gelokaliseerd object van een bekend punt. Een niet-gelokaliseerde GeoJSON Feature mag geometry: null bevatten; dat is geen Point met null-coördinaten en geen vervanging van onbekende data door de echte positie [0,0]. Beschrijf ook wat het punt voorstelt: waargenomen ingang, geocodeerd adres of berekend midden, met herkomst en datum. Meer decimalen maken een schatting niet zekerder.
Schuif de tabel horizontaal om alle kolommen te lezen. Zet met het toetsenbord de focus op de tabel en gebruik de pijltjestoetsen.
| Geval | Betekenis | Nuttige controle |
|---|---|---|
| Point · coordinates: [2.35,48.86] | Lengtegraad 2.35; breedtegraad 48.86 | Vergelijken met benoemde bronvelden |
| Point · coordinates: [48.86,2.35] | Aannemelijke getallen, verwisseld in deze oefening | Betekenis controleren; syntax volstaat niet |
| Feature · geometry: null | Niet-gelokaliseerd object; structuurfragment | Ontbrekende waarde documenteren zonder punt te verzinnen |
| Positie [0,0] | Bestaande coördinaten, geen afwezigheid | Niet automatisch gebruiken voor onbekende waarden |
Bekijk publicatie en hergebruik
Identificeer bronhergebruiksvoorwaarden en attributie-informatie die moet worden behouden. Laat de juiste reviewers de publicatierechten en mogelijke persoonsgegevens beoordelen voordat ze openbaar worden vrijgegeven. Een elders zichtbaar adres maakt niet automatisch elke kopie geschikt voor publicatie.
Test downloads zonder interne tools of speciale accounts wanneer openbare toegang wordt beloofd. Controleer formaat, codering en integriteit. Geef een versiereferentie of checksum zodat feedback kan worden gekoppeld aan het gedownloade bestand.
Versies en correcties onderhouden
Kies een realistische beoordelingsfrequentie en een contactpersoon voor problemen. Beschrijf toegevoegde, verwijderde of herdefinieerde velden wanneer schema's veranderen. Onderscheid correcties van nieuwe metingen om te voorkomen dat u valse veranderingen in een tijdreeks maakt.
Bewaar nuttige versies en notities met een duidelijk vervangingsbeleid. Publicatiedocumentatie moet een andere persoon extractie laten reproduceren of de beperkingen ervan begrijpen. Een downloadteller vervangt geen documentatiekwaliteit.
Primaire documentatie: data.gouv.fr : Bien documenter un jeu de données.
Onderscheid de dataset van zijn distributies. Een CSV- en JSON-bestand kunnen dezelfde dataset in twee formaten weergeven; tel ze niet automatisch als twee onafhankelijke metingen. DCAT omschrijft een distributie als een specifieke representatie van een dataset. Vergelijk wel dekking, precisie, velden en versie: twee distributies zijn niet noodzakelijk zonder informatieverlies gelijkwaardig.
Voeg een versieaanduiding en wijzigingsgeschiedenis toe. Een adres voor de ‘nieuwste versie’ kan stabiel blijven, maar de gebruikte versie moet identificeerbaar zijn. Onderscheid ook correctie en nieuwe waarneming: een nieuwe maand meten corrigeert niet vanzelf de vorige. Leg dit verband tussen versies en reeksen uit voordat u cijfers vergelijkt.
Schuif de tabel horizontaal om alle kolommen te lezen. Zet met het toetsenbord de focus op de tabel en gebruik de pijltjestoetsen.
| Documentatie-element | Wat het onderscheidt | Nuttige controle |
|---|---|---|
| Dataset | Het beschreven onderwerp, bereik en de waarnemingen. | De identiteit blijft begrijpelijk ongeacht het bestandsformaat. |
| CSV- of JSON-distributie | Een specifieke representatie van de dataset. | Vergelijk velden, precisie en dekking vóór u gelijkwaardigheid aanneemt. |
| Geïdentificeerde versie | Een bepaalde toestand en de wijzigingsgeschiedenis. | Vind de aangehaalde versie terug, ook als een actueel adres is bijgewerkt. |
| Correctie of nieuwe periode | Een herziene waarde of een andere waarneming. | Presenteer een nieuwe maand niet als automatische correctie van de vorige. |
- W3C DCAT 3 : Distributies
Geraadpleegd op 22 oktober 2026; datasets tegenover representaties en mogelijke verschillen in getrouwheid.
- W3C : Data op het web en versies
Geraadpleegd op 22 oktober 2026; versieaanduiding, geschiedenis en waarnemingen uit verschillende perioden.
Referentiedocumenten
- W3C : Gegevens op het web Best Practices · Bron geraadpleegd
- IETF : GeoJSON RFC 7946 · Bron geraadpleegd
- data.gouv.fr : Bien documenter un jeu de données
Inhoud bijgewerkt
Gedocumenteerde referenties voor dit onderwerp
| Referentie | Waarde of syntaxis | Toepassingsgebied |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | Velden met komma’s, aanhalingstekens of regeleinden krijgen aanhalingstekens; interne tekens worden verdubbeld. |
| RFC 8259 · JSON | application/json · UTF-8 | Standaard-JSON staat geen commentaar of afsluitende komma toe; tekenreeksen gebruiken dubbele aanhalingstekens. |
De datums geven aan wanneer de bronnen zijn geraadpleegd. Deze gegevens vormen geen site-audit of algemene conformiteitsverklaring.
