okestonia / esindus

Open Knowledge Estonia esindus GitHubis
Creative Commons Zero v1.0 Universal
10 stars 4 forks source link

Vaja avaandmete kataloogi musternäidet teistele viitamiseks #41

Closed boamaod closed 4 years ago

boamaod commented 6 years ago

Oleks vaja lihast-luust näidet sellest avaandmete kataloogist, mida võiks teistele eeskujuks tuua. Mis tingimused peaks olema täidetud ja mis võiks olla kriteeriumid? Loomulikult on kriteeriumid avaldamisjuhises ja rohelises raamatus välja toodud, aga oleks vaja just näidata, kes on seda reaalselt nii hästi teinud, et seda võiks teistele eeskujuks tuua stiilis "mine ja vaata seda kataloogi"...

Minu jaoks peamised kriteeriumid, mida rõhutada (mh osaliselt välja toodud #23 all):

Mis veel? Mis asutus(t)e kataloog(id) võiks olla parima praktika musternäiteks?

boamaod commented 6 years ago

Lisada võiks vist:

Teen otsa lahti KOVidega:

Pärnu

Avaandmete kataloog pole linna kodulehelt leitav, kuid on peidus dokumendiregistri lehel selle laienduse kujul:

Andmed on ära toodud As is põhimõttel, riigiportaali pole kantud, litsentse pole, juhendeid pole -- positiivne on masinloetav ja taaskasutamist võimaldav formaat, mis siiski pole eriti kasulik, sest andmete struktuuri ja uuenemise kohta tuleb kõik ise välja mõtelda. Toodud on ära ainult linnavalitsuse üldkontakt.

Positiivne: JSON on hea formaat, sisuliselt võivad andmed olla ägedad ja kasutatavad.

Tallinn

Andmed on koduehelt lihtsalt leitavad ja URL on ootuspärane:

Andmed on avaldatud koos elementaarsete kirjeldustega, iga andmehulk on eraldi kirjeldatud, kuigi puudub andmete ajalugu ja selge märkus uuendamise intervalli kohta, ka on kirjeldamata andmete struktuur, päritolu kohta on info samas kohati olemas. Andmetel puudub litsentsimärgis ja lehekülje allservas olev "Kõik õigused kaitstud © 2018 Tallinn" osutab vastuoluliselt, et andmete kasutamine poleks ilma luba küsimata justkui üldse lubatud.

Andmed ise tunduvad olevat mõistlikus formaadis, masinloetav, seal kus võimalik ja mitte, kus mitte, andmetele on peamine etteheide andmehulkade ajaloo puudumine (see võib samas olla osaliselt olemas XML struktuuris vmt, aga kuna see pole dokumenteeritud, siis on ajaloolise vaate olemasolu ebaselge).

Tallinna avaandmed on kantud riigiportaali, aga ainult üldkirjena, mis ei vasta portaali kasutusjuhistes seatud nõudele, et portaali peab olema kantud iga andmehulk eraldi. Andmetel puudub litsentsimärge ka riigiportaalis. Link riigiportaalile avaandmete kataloogis puudub.

Avaandmete kataloogi juures puudu kontaktinfo või muud juhised andmete kasutamiseks, ka pole toodud ära andmete avaldamise üldpõhimõtteid.

Positiivne: Eesti esimene ja kõige põhjalikum avaandmete kataloog KOVide seas, oleks litsentsid, andmete ajalugu ja kontaktinfo ka olemas, siis oleks KOVidest konkurentsitult esimene. Ka vajaks andmed korrektset esitamist riigiportaalis.

Tartu

Linna avaandmete kataloog on rohelise raamatu nõuetele vastava URLi alt leitav ning leitav ka linna kodulehelt:

Andmetel on olemas litsents, kuigi seda pole iga andmehulga juures eraldi välja toodud, andmehulkadel on olemas elementaarsed kirjeldused ja märgitud on ka uuendamise intervall, kuid puudub andmehulkade struktuuri kirjeldus ning ajalooline vaade andmetest (see võib siiski olla peidetud mõne JSON vmt andmehulga struktuuri). Kuigi avaandmete kataloogil on üldosa, siis see ei kirjelda Tartu linna andmete avaldamise põhimõtteid, vaid kopeerib riigiportaali avalehte. Ka puudub avaandmete kataloogi juures kontaktinfo neile, kes sooviks andmete kohta lisainfot, lehekülje allservas on linnavalitsuse üldkontakt.

Andmete kataloogi kohta on kirje riigiportaalis, kuid see ei vasta portaali kasutamise nõuetele ega kirjelda iga andmehulka eraldi. Ka on riigiportaalis toodud ära teine litsents kui linna kodulehel (CC BY vs CC BY-SA). Link riigiportaalile avaandmete kataloogis puudub.

Positiivne: Tartul on kvaliteetsed andmed olemas, ka on kataloogi loomisel 2017. aastal põhiasjadele mõteldud (sj litsentsidele), kuid avaandmetega tegelemine on jäänud poolele teele, vaja oleks kontaktinfot ja andmete avaldamise põhimõtete kirjeldamist, ajalooline vaade oleks vaja lisada ning andmehulkade struktuurid vajaks kasutamiseks täpsemat lahtikirjutamist. Loomulikult tuleks korrigeerida andmete esitus riigiportaalis.

boamaod commented 6 years ago

Politsei- ja Piirivalveamet

Andmed leitavad mõningate komplikatsioonidega PPA kodulehelt (kodulehe otsing läbi Google'i ja kataloogi aadress ei vasta ühelegi standardile):

Andmete avaldamise põhimõtete kirjeldus on eeskujulik, sj on kirjeldatud andmete päritolu ning uuendamise intervall. Andmetel puudub kataloogis standardne litsents, kuigi lisatud seletuskirjas on öeldud, et andmeid "võivad kõik vabalt ja avalikult kasutada" -- sellest kahjuks ei piisa reaalseks kasutamiseks tarkvaraprojektides. Andmete struktuur ja uuendamine on kirjeldatud väga hästi, aga see võiks olla iga andmehulga kohta eraldi, samamoodi on küll kirjas andmete uuendamise intervall, kuid puuduvad ajaloolised andmed (võib väita, et see pole kumuleeruvate andmete puhul hädavajalik, aga siiski). Andmete formaat ja avaldamise viis on mõistlikud ning võimaldavad andmeid taaskasutada.

Kataloogi kirjelduses on toodud spetsiaalne kontaktaadress, kust saab lisainfot. Riigiportaalis on andmed kirjeldatud korrektselt iga andmehulk eraldi, seal on ka toodud litsentsiks CC BY (mis peaks olema toodud ka PPA lehel). Andmete kirjeldused portaalis pole päris täielikud, nt uuendamise intervall, ajaline ulatus jmt tunduvad ebaühtlased või suvalised. Huvitaval kombel on riigiportaalis rohkem andmeid kui PPA enda avaandmete kataloogis -- iseenesest positiivne, et andmeid on oodatust rohkem, aga see tekitab samas ka segadust.

Positiivne: andmed on põhjalikud ja andmete struktuuri kirjeldus teeb need reaalselt kasutatavaks, ka korraldas PPA oma andmete tutvustusürituse ning avaadmete jaoks on asutuses määratud konkreetne vastutaja -- see koos korrektsete kirjeldustega riigiportaalis julgustab andmete potentsiaalseteid kasutajaid andmeid uurima ja nendega tegelema (vt nt Renee Trisbergi FB lehelt või Annegrete blogipostitust riigiportaali blogis või Taivo Pungase andmekunsti).

boamaod commented 6 years ago

Justiitsministeerium

Andmed on leitavad kodulehe otsingu kaudu, sh rohelises raamatus nõutud aadressilt, küll edasisuunamisega, aga siiski:

Andmetel puudub avaldamise põhimõtete üldkirjeldus, aga on korrektselt määratud litsents (võiks olla iga andmehulga juures selgelt välja toodud, sj viitavad mõned andmehulgad edasi alamlehtedele, kus litsentsi siiski ära toodud pole ja pole selge, kas ja mis litsents seal siis ikkagi kehtib), puuduvad koondatult üksikute andmehulkade struktuuri kirjeldused, küll on olemas avaldamise intervall ja märkus formaadi kohta. Erinevalt paljudest teistest kataloogidest on mõnedel andmehulkadel ära toodud ka andmete ajalugu (nt patendiameti andmed).

Riigiportaalis on toodud üheksast kataloogis olevast andmehulgast viis, kohati on kirjetes puudu nt andmete ajaline ulatus jm väljad. Litsentsimärgised ühtivad asutuse enda kataloogis tooduga ja asutuse enda kataloogis on link riigiportaalile (aga võiks olla ehk teabevaldaja enda lehele riigiportaalis).

Puudub kontaktisik andmete kohta lisainfo saamiseks.

Positiivne: vähemalt osa puhul andmetest on olemas ajalooline vaade ning on toodud link riigi avaandmete portaalile.

boamaod commented 6 years ago

Panin siin pakutud kriteeriumid kokkuvõtlikult kirja #42 alla, sj koostasin siintoodud näidete alusel tabeli homse esitluse jaoks.

tanelmallo commented 6 years ago

Need on head olemasolevad näited kaardistuse alustuseks. Samas on Eestis üldisemad avaandmetega seotud praktikad välja kujunemata. Mh OKEE ja MKM ühistegevuse käigus kujunev ökosüsteem kujundab tegevuspõhimõtted ja parimad praktikad (sh standardites kokku leppimise kaudu), mille alusel on võimalik koostada ka dokumentatsioon/juhendmaterjalid (sh kataloogi musternäited).

boamaod commented 6 years ago

Teema vahekokkuvõtteks Tallinna koosoleku jaoks koostatud slaidid (18.04.2018).

infokujur commented 5 years ago

@boamaod , kas Sa tegeled sellega või paneme selle tegevusliini praeguseks kinni?

infokujur commented 4 years ago

Tegevusi ja tegijat ei ole. Kuni aktiveerumiseni arhiveeritud.