Julkaise ymmärrettävää, dokumentoitua avointa dataa

Arvioitu lukuaika: 3 min · Julkaistu 1.10.2026

vahvistaa alkuperää ja laajuutta

Kuvaa tuottaja, keräysmenetelmä, ajanjakso ja maantieteellinen tai temaattinen kattavuus. Erottele erotus-, päivitys- ja mittauspäivämäärät. Tänään julkaistu tiedosto saattaa kuvata aikaisempaa mittausta; Julkaisu ei muuta viitevuotta.

Ilmoita puuttuvat alueet ja likimääräiset arvot, joissa lähde tunnistaa ne. Älä täytä aukkoa julkistamattomalla arviolla. Data.gouv.fr:n dokumentaatioohjeissa käsitellään tuotantokontekstia, rakennetta ja mahdollisia epäjohdonmukaisuuksia.

antaa sanakirjan ja esimerkin

Selitä jokainen kenttä, yksikkö, tyyppi, puuttuva arvo ja viitekoodi. Anna pieni luettava esimerkki, joka on yhdenmukainen koko tietojoukon kanssa. jossa tunnisteet yhdistävät taulukoita, asiakirjasuhteita ja mahdollisesti vertaansa vailla olevia rivejä.

erottaa entiteetit etiketeistään. Kunnalla voi olla useita postinumeroita ja tuote useita muunnelmia. Dokumentaation pitäisi auttaa estämään harhaanjohtava aggregointi tai duplikaatio, joka poistaa hyödyllisen suhteen.

Tarkista julkaisu ja käytä uudelleen

Tunnista lähteen uudelleenkäyttöehdot ja attribuutiotiedot säilytettäväksi. Pyydä asianmukaisia arvioijia arvioimaan julkaisuoikeudet ja mahdolliset henkilötiedot ennen julkistamista. Muualla näkyvä osoite ei automaattisesti tee jokaisesta kopiosta julkaisuun sopivaa.

Testaa latauksia ilman sisäisiä työkaluja tai erityisiä tilejä, kun julkista pääsyä luvataan. Tarkista muoto, koodaus ja eheys. Anna versioviittaus tai tarkistussumma, jotta palaute voidaan liittää ladattuun tiedostoon.

Ylläpidä versioita ja korjauksia

Valitse realistinen arvostelutiheys ja yhteystieto ongelmien varalta. Kuvaa lisätyt, poistetut tai uudelleenmääritetyt kentät, kun skeemat muuttuvat. Erota korjaukset uusista mittauksista välttääksesi väärien muutosten luomisen aikasarjaan.

Säilytä hyödyllisiä versioita ja muistiinpanoja selkeällä korvauskäytännöllä. Julkaisudokumentaation tulisi antaa toisen henkilön toistaa poiminta tai ymmärtää sen rajoitukset. Latauslaskuri ei korvaa dokumentaation laatua.

ensisijainen dokumentaatio: data.gouv.fr — Tietojoukon dokumentointi huolellisesti.

viiteasiakirjat

data.gouv.fr — Tietojoukon dokumentointi huolellisesti

Sisältö päivitetty 1.10.2026

Kirjaa tarkistukset ja havainnot verkkosivuston testilokiin

toiminnallinen validointimatriisi, joka mukautuu projektiin

Nämä ehdotetut kontrollit käyttävät kuvitteellisia tapauksia. Päätä, mitä käyttäytymistä tiimin kanssa odotetaan, kirjoita tulos muistiin ja määritä ratkaisemattomia eroja ennen julkaisemista.

testitapaukset, odotetut tulokset ja hyödyllisiä todisteita
Asia	odotettu tulos	todiste säilyttää
mainostettu julkinen lataus	Ulkopuolinen henkilö saa luettavan tiedoston ilman sisäisiä työkaluja.	osoite, muoto, koko ja onnistunut avaus yhteisessä lukijassa.
Tarkistettu kenttä ja yksikkö	Esimerkki ja koko tiedosto käyttävät samaa määritelmää.	Sanakirja, näyte ja tunnettujen arvojen vertailu molemmissa esityksissä.
Tuntematon ja vertaansa vailla oleva tunniste	rajoitukset pysyvät näkyvissä ilman, että ne korvaavat uskottavaa arvoa.	Vaikuttavat rivit ja dokumentoidut säännöt tuntemattomien tai vertaansa vailla olevien tietojen esittämiseen.
julkaistu korjaus	Uudelleenkäyttäjä voi erottaa korjauksen uudesta mittauksesta.	versio, muutoskuvaus ja julkaistun tiedoston viitepäivämäärät.

Usein kysyttyjä kysymyksiä

Minkä päivämäärän tulee olla tiedoston mukana?

Esitä tarvittaessa poiminta, viimeinen muutos ja katettu ajanjakso erikseen nimettyinä päivämäärinä. Älä esitä latausaikaa automaattisesti populaation tai muun mittauksen viitevuotena.

Tekeekö lisenssi pelkästään tiedoista käyttökelpoisia?

Se määrittelee uudelleenkäyttöehdot, mutta myös kentät, yksiköt, tunnisteet, kattavuus, laatu ja versiot tarvitsevat selityksen. toisen henkilön pitäisi pystyä lisääntymään tai ainakin ymmärtämään sen käyttöä.