From bbf73d22a200a7b8db24e3f409dd7a3dac453ec6 Mon Sep 17 00:00:00 2001 From: Jeff Reiffers Date: Thu, 8 Aug 2024 15:22:30 +0200 Subject: [PATCH 1/5] chore: use sectlinks instead of sectanchors to prevent accessibility issues regarding empty links --- docs/main.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/main.adoc b/docs/main.adoc index a121b58..9a3ca15 100644 --- a/docs/main.adoc +++ b/docs/main.adoc @@ -9,7 +9,7 @@ Digitaliseringsdirektoratet (Digdir) / The Norwegian Digitalisation Agency :toc: left ifdef::backend-pdf[:toc: macro] :toclevels: 5 -:sectanchors: +:sectlinks: :title-logo-image: image:images/Digdir.png[pdfwidth=30vw] image::images/Digdir.png[width=50%, pdfwidth=30vw, link=https://digdir.no/] From 8e16b25810f3c4c871df96144ef94158ce6f9512 Mon Sep 17 00:00:00 2001 From: jimjyang Date: Wed, 4 Dec 2024 08:23:00 +0100 Subject: [PATCH 2/5] Issue #15 (ang. innholdsfortegnelsen) --- docs/main.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/main.adoc b/docs/main.adoc index 9a3ca15..0a8e41e 100644 --- a/docs/main.adoc +++ b/docs/main.adoc @@ -4,7 +4,7 @@ include::locale/attributes.adoc[] Digitaliseringsdirektoratet (Digdir) / The Norwegian Digitalisation Agency :description: Veileder for beskrivelse av kvalitet på datasett – kvantifiserbar kvalitet :doctype: book -:docinfo: +:docinfo: shared :icons: font :toc: left ifdef::backend-pdf[:toc: macro] @@ -21,7 +21,7 @@ image::images/Digdir.png[width=50%, pdfwidth=30vw, link=https://digdir.no/] //{description} *Publisert*: 2020-02-20 + -*Oppdatert*: 2023-02-14 (definisjonene er tatt ut fra veilederen og lenket til der de finnes) + +*Oppdatert*: 2024-12-04 (kun redaksjonelle justeringer) + *Gjeldende versjon*: https://data.norge.no/guide/veileder-kvantifiserbar-kvalitet + *Redaktørens utkast*: https://informasjonsforvaltning.github.io/veileder-kvantifiserbar-kvalitet/ From bd6f8c1030c378d0f75e1750800f0e90d3694407 Mon Sep 17 00:00:00 2001 From: jimjyang Date: Wed, 4 Dec 2024 08:28:55 +0100 Subject: [PATCH 3/5] =?UTF-8?q?Issue=20#14=20(m=C3=A5leresultat=20->=20kva?= =?UTF-8?q?litetsm=C3=A5ling)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/dimensjoner.adoc | 24 ++++++++++++------------ docs/hensyn.adoc | 2 +- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/dimensjoner.adoc b/docs/dimensjoner.adoc index 97aea10..9f685bf 100644 --- a/docs/dimensjoner.adoc +++ b/docs/dimensjoner.adoc @@ -10,24 +10,24 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k ----- :dsBuildings a dcat:Dataset ; # et datasett - dqv:hasQualityMeasurement # har måleresultat + dqv:hasQualityMeasurement # har kvalitetsmåling :qmMissingObjects , # manglende enheter :qmNumberMissingObjects , # antall manglende enheter :qmRateMissingObjects . # andel manglende enheter -:qmMissingObjects a dqv:QualityMeasurement ; # et måleresultat +:qmMissingObjects a dqv:QualityMeasurement ; # en kvalitetsmåling dqv:isMeasurementOf ; # manglende enheter dqv:value "true"^^xsd:boolean ; rdfs:comment "Ja, noen bygninger mangler i datasettet."@nb , "Yes, some buildings are missing in the dataset."@en . -:qmNumberMissingObjects a dqv:QualityMeasurement ; # et måleresultat +:qmNumberMissingObjects a dqv:QualityMeasurement ; # en kvalitetsmåling dqv:isMeasurementOf ; # antall manglende enheter dqv:value "2"^^xsd:nonNegativeInteger ; rdfs:comment "To bygninger mangler i datasettet."@nb , "Two buildings are missing in the dataset."@en . -:qmRateMissingObjects a dqv:QualityMeasurement ; # et måleresultat +:qmRateMissingObjects a dqv:QualityMeasurement ; # en kvalitetsmåling dqv:isMeasurementOf ; # andel manglende enheter dqv:value "0.02"^^xsd:double ; rdfs:comment "0,02% av bygninger mangler i datasettet."@nb , @@ -45,10 +45,10 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k ----- :dsBuildings a dcat:Dataset ; # et datasett - dqv:hasQualityMeasurement # har måleresultat + dqv:hasQualityMeasurement # har kvalitetsmåling :qmNumberImputedValues . # antall impurterte verdier -:qmNumberImputedValues a dqv:QualityMeasurement ; # et måleresultat +:qmNumberImputedValues a dqv:QualityMeasurement ; # en kvalitetsmåling dqv:isMeasurementOf ; # andel enheter med imputert verdi for en gitt egenskap dqv:value "4"^^xsd:nonNegativeInteger ; rdfs:comment "Fire bygninger har fått imputert verdi for egenskapen 'byggeår'."@nb , @@ -68,10 +68,10 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k ----- :dsBuildings a dcat:Dataset ; # et datasett - dqv:hasQualityMeasurement # har måleresultat + dqv:hasQualityMeasurement # har kvalitetsmåling :qmOverallDelay . # samle tidsdifferanse -:qmOverallDelay a dqv:QualityMeasurement ; # et måleresultat +:qmOverallDelay a dqv:QualityMeasurement ; # en kvalitetsmåling dqv:isMeasurementOf ; # samlet tidsdifferanse dqv:value "P30D"^^xsd:duration ; rdfs:comment "Det tar i gjennomsnitt 24 dager fra en bygning står ferdig eller er revet til den er innlemmet i eller tatt ut fra datasettet. Medregnet intern saksbehandlingstid blir den samlede tidsdifferansen 30 dager."@nb , @@ -96,10 +96,10 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k ----- :dsBuildings a dcat:Dataset ; # et datasett - dqv:hasQualityMeasurement # har måleresultat + dqv:hasQualityMeasurement # har kvalitetsmåling :qmRateInconsistencyGivenProperties . # andel enheter med inkonsistens mellom gitte egenskaper -:qmRateInconsistencyGivenProperties a dqv:QualityMeasurement ; # et måleresultat +:qmRateInconsistencyGivenProperties a dqv:QualityMeasurement ; # en kvalitetsmåling dqv:isMeasurementOf ; # andel enheter med inkonsistens mellom gitte egenskaper dqv:value "0.03"^^xsd:double ; rdfs:comment "0,03% av bygningene i datasettet står oppført med 'bruksareal' som er høyere enn 'bruttoareal'."@nb , @@ -121,10 +121,10 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k ----- :dsBuildings a dcat:Dataset ; # et datasett - dqv:hasQualityMeasurement # har måleresultat + dqv:hasQualityMeasurement # har kvalitetsmåling :qmRateIncorrectIdentifier . # andel enheter med identifikatorfeil -:qmRateIncorrectIdentifier a dqv:QualityMeasurement ; # et måleresultat +:qmRateIncorrectIdentifier a dqv:QualityMeasurement ; # en kvalitetsmåling dqv:isMeasurementOf ; # andel enheter med inkonsistens mellom gitte egenskaper dqv:value "0.01"^^xsd:double ; rdfs:comment "0,01% av bygningene i datasettet har fått feil identifikator."@nb , diff --git a/docs/hensyn.adoc b/docs/hensyn.adoc index 9bef149..608578b 100644 --- a/docs/hensyn.adoc +++ b/docs/hensyn.adoc @@ -17,7 +17,7 @@ I predefineringen av kvalitetsmål er det valgt å bruke såkalte negativt laded Et eksempel er kvalitetsmålet «andel manglende enheter» som handler om mangel. Det vil være for eksempel 2 % _mangel_ (negativt ladet) istedenfor 98 % _fullstendig_ (positivt ladet) som oppgis. Det er viktig å være klar over dette, både ved angivelse av verdier til kvalitetsmål og ved visning av verdiene i et sluttbrukergrensesnitt. I et konkret sluttbrukergrensesnitt kan man godt presentere det positivt (f.eks. regne om «2 % mangel» til «98 % fullstendig» og presentere resultatet positivt). === Fritekst kan brukes som supplerende forklaring -https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO (Norsk applikasjonsprofil av DQV)] tillater bruk av fritekst-kommentarer som supplerende forklaringer til et kvantifiserbart kvalitetsmåleresultat. For eksempel, til vårt eksempeldatasett «Bygninger», hvis resultatet på kvalitetsmålet «andel enheter med manglende verdi for en gitt egenskap» er «2 %», kan man i fritekst-kommentaren spesifisere hvilken egenskap mangelen gjelder, for eksempel: «Dette gjelder egenskap ‘byggeår’». +https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO (Norsk applikasjonsprofil av DQV)] tillater bruk av fritekst-kommentarer som supplerende forklaringer til en kvantifiserbar kvalitetsmåling. For eksempel, til vårt eksempeldatasett «Bygninger», hvis resultatet på kvalitetsmålet «andel enheter med manglende verdi for en gitt egenskap» er «2 %», kan man i fritekst-kommentaren spesifisere hvilken egenskap mangelen gjelder, for eksempel: «Dette gjelder egenskap ‘byggeår’». For de aller fleste brukstilfeller antok arbeidsgruppen som utarbeidet disse definisjonene, at det burde holde med supplerende fritekst-kommentarer. For avanserte kvalitetsbeskrivelser, for eksempel der det er behov for å avgi resultater for hver enkelt egenskap, er det i henhold til DQV mulig å oppgi slike resultater som egne datasett (https://www.w3.org/TR/vocab-dqv/#dqv:QualityMeasurementDataset[dqv:QualityMeasurementDataset]). For eksempel en «tabell» som sier «2 % mangel» for egenskap «byggeår», «3 % mangel» for egenskap «bruksareal» og «0 % mangel» for alle de andre egenskapene: From 3c0bd76b6cc09c236c9513158c34328a7d841ea1 Mon Sep 17 00:00:00 2001 From: jimjyang Date: Wed, 4 Dec 2024 08:39:58 +0100 Subject: [PATCH 4/5] Issue #16 (eksterne lenker) --- docs/dimensjoner.adoc | 14 +++++++------- docs/hensyn.adoc | 4 ++-- docs/innledning.adoc | 12 ++++++------ docs/main.adoc | 2 +- docs/navnerom.adoc | 6 +++--- docs/oversikt.adoc | 34 +++++++++++++++++----------------- 6 files changed, 36 insertions(+), 36 deletions(-) diff --git a/docs/dimensjoner.adoc b/docs/dimensjoner.adoc index 9f685bf..ee58594 100644 --- a/docs/dimensjoner.adoc +++ b/docs/dimensjoner.adoc @@ -1,6 +1,6 @@ === Kvalitetsdimensjonen «fullstendighet»[[fullstendighet]] -Kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#completeness[fullstendighet] handler både om mangel på elementer i datasettet (kvalitetsdeldimensjon https://data.norge.no/vocabulary/quality-dimension#under-coverage[underdekning]) og overflødige elementer i datasettet (kvalitetsdeldimensjon https://data.norge.no/vocabulary/quality-dimension#over-coverage[overdekning]). Disse har kvalitetsmål på både enhets- og egenskapsnivå. Videre kan fullstendighet måles ut fra tre ulike verdityper, boolsk (ja/nei) på enhetsnivå, antall og andel på både enhets- og egenskapsnivå. Fritekst-feltet kan brukes til å opplyse om hvilken gitt egenskap som det mangler verdier for (for eksempel «bruksareal»). +Kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#completeness[fullstendighet ⧉, window="_blank", role="ext-link"] handler både om mangel på elementer i datasettet (kvalitetsdeldimensjon https://data.norge.no/vocabulary/quality-dimension#under-coverage[underdekning ⧉, window="_blank", role="ext-link"]) og overflødige elementer i datasettet (kvalitetsdeldimensjon https://data.norge.no/vocabulary/quality-dimension#over-coverage[overdekning ⧉, window="_blank", role="ext-link"]). Disse har kvalitetsmål på både enhets- og egenskapsnivå. Videre kan fullstendighet måles ut fra tre ulike verdityper, boolsk (ja/nei) på enhetsnivå, antall og andel på både enhets- og egenskapsnivå. Fritekst-feltet kan brukes til å opplyse om hvilken gitt egenskap som det mangler verdier for (for eksempel «bruksareal»). [cols=100%] |=== @@ -35,7 +35,7 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k ----- |=== -Fullstendighet handler også om https://data.norge.no/vocabulary/quality-dimension#imputation[imputering]. Imputering er å fylle inn verdi for en gitt egenskap der verdien mangler eller er ubrukbar. Dette gjøres for å håndtere manglende verdier for egenskaper (tomme celler) i et datasett der disse manglende verdiene skaper problemer for, blant annet, analysen av dataene. Imputerte verdier som kvalitetsmål gir datatilbyderen mulighet til å informere brukerne av datasettet at det er egenskaper i datasettet som ikke er hentet fra virkeligheten. +Fullstendighet handler også om https://data.norge.no/vocabulary/quality-dimension#imputation[imputering ⧉, window="_blank", role="ext-link"]. Imputering er å fylle inn verdi for en gitt egenskap der verdien mangler eller er ubrukbar. Dette gjøres for å håndtere manglende verdier for egenskaper (tomme celler) i et datasett der disse manglende verdiene skaper problemer for, blant annet, analysen av dataene. Imputerte verdier som kvalitetsmål gir datatilbyderen mulighet til å informere brukerne av datasettet at det er egenskaper i datasettet som ikke er hentet fra virkeligheten. [cols=100%] |=== @@ -58,7 +58,7 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k === Kvalitetsdimensjonen «aktualitet» -Det er predefinert ett kvalitetsmål i kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#currentness[aktualitet] – https://data.norge.no/vocabulary/quality-metric#qm-currentness-1001[samlet tidsdifferanse]. +Det er predefinert ett kvalitetsmål i kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#currentness[aktualitet ⧉, window="_blank", role="ext-link"] – https://data.norge.no/vocabulary/quality-metric#qm-currentness-1001[samlet tidsdifferanse ⧉, window="_blank", role="ext-link"]. [cols=100%] |=== @@ -82,11 +82,11 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k === Kvalitetsdimensjonen «konsistens» -Kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#consistency[konsistens] gjelder konsistens innad i ett og samme datasett, og ikke konsistens mellom datasett. Om datasettet er i samsvar med gitte standarder og krav er ikke definert på nytt som et eget kvalitetsmål ettersom dette er dekket av DCAT-AP-NO https://data.norge.no/specification/dcat-ap-no/#datasett-i-samsvar-med[(Datasett: i samsvar med)]. Et eksempel på slik innbyrdes inkonsistens er når bruksareal er større enn bruttoareal for en bygning. +Kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#consistency[konsistens ⧉, window="_blank", role="ext-link"] gjelder konsistens innad i ett og samme datasett, og ikke konsistens mellom datasett. Om datasettet er i samsvar med gitte standarder og krav er ikke definert på nytt som et eget kvalitetsmål ettersom dette er dekket av DCAT-AP-NO https://data.norge.no/specification/dcat-ap-no/#datasett-i-samsvar-med[(Datasett: i samsvar med) ⧉, window="_blank", role="ext-link"]. Et eksempel på slik innbyrdes inkonsistens er når bruksareal er større enn bruttoareal for en bygning. Kvalitetsdimensjonen konsistens kan i mange tilfeller lett forveksles med kvalitetsdimensjonen nøyaktighet. Det som bl.a. skiller nøyaktighet og konsistens er at når det gjelder konsistens _vet man ut fra vurdering av flere egenskaper at det er feil, men ikke hvilken eller hvilke egenskaper som er feil_ i datasettet. I eksemplet over er det ikke mulig å avgjøre om det er bruksareal eller bruttoareal (eller begge) som er feil. Når det gjelder nøyaktighet, _vet man hvilken egenskap som er feil_ (for eksempel feil identifikator). -Det første kvalitetsmålet i konsistens (https://data.norge.no/vocabulary/quality-metric#qm-consistency-1001[andel enheter med inkonsistente egenskaper]) måles på enhetsnivå. Her måles andel enheter som har en form for inkonsistens knyttet til seg. Det andre kvalitetsmålet (https://data.norge.no/vocabulary/quality-metric#qm-consistency-1002[andel enheter med inkonsistens mellom gitte egenskaper]) går mer i dybden og brukes der man har innsikt i hva inkonsistensen gjelder på egenskapsnivå. Kvalitetsmålene oppgis i prosentandel; fritekstfeltet kan brukes til å forklare for hvilke egenskaper inkonsistensen gjelder. +Det første kvalitetsmålet i konsistens (https://data.norge.no/vocabulary/quality-metric#qm-consistency-1001[andel enheter med inkonsistente egenskaper ⧉, window="_blank", role="ext-link"]) måles på enhetsnivå. Her måles andel enheter som har en form for inkonsistens knyttet til seg. Det andre kvalitetsmålet (https://data.norge.no/vocabulary/quality-metric#qm-consistency-1002[andel enheter med inkonsistens mellom gitte egenskaper ⧉, window="_blank", role="ext-link"]) går mer i dybden og brukes der man har innsikt i hva inkonsistensen gjelder på egenskapsnivå. Kvalitetsmålene oppgis i prosentandel; fritekstfeltet kan brukes til å forklare for hvilke egenskaper inkonsistensen gjelder. [cols=100%] |=== @@ -109,9 +109,9 @@ Eksemplet uttrykt i RDF Turtle i henhold til DQV-AP-NO blir (eksemplet er ikke k === Kvalitetsdimensjonen «nøyaktighet» -I kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#accuracy[nøyaktighet] måles i hvilken grad dataene korrekt representerer virkeligheten. +I kvalitetsdimensjonen https://data.norge.no/vocabulary/quality-dimension#accuracy[nøyaktighet ⧉, window="_blank", role="ext-link"] måles i hvilken grad dataene korrekt representerer virkeligheten. -Nøyaktighet av en dataverdi er ofte avhengig av type data, og kvalitetsmål for nøyaktighet blir fort svært fag- og sektorspesifikke. De mest generelle nøyaktighetsmålene er derfor plukket ut i denne sammenheng: https://data.norge.no/vocabulary/quality-dimension#identifier-correctness[identifikatorriktighet] som går på identifikasjonsnøkler, og https://data.norge.no/vocabulary/quality-dimension#classification-correctness[klassifikasjonsriktighet] som går på bruk av klassifikasjoner og kodeverk. +Nøyaktighet av en dataverdi er ofte avhengig av type data, og kvalitetsmål for nøyaktighet blir fort svært fag- og sektorspesifikke. De mest generelle nøyaktighetsmålene er derfor plukket ut i denne sammenheng: https://data.norge.no/vocabulary/quality-dimension#identifier-correctness[identifikatorriktighet ⧉, window="_blank", role="ext-link"] som går på identifikasjonsnøkler, og https://data.norge.no/vocabulary/quality-dimension#classification-correctness[klassifikasjonsriktighet ⧉, window="_blank", role="ext-link"] som går på bruk av klassifikasjoner og kodeverk. [cols=100%] |=== diff --git a/docs/hensyn.adoc b/docs/hensyn.adoc index 608578b..0daacbd 100644 --- a/docs/hensyn.adoc +++ b/docs/hensyn.adoc @@ -17,9 +17,9 @@ I predefineringen av kvalitetsmål er det valgt å bruke såkalte negativt laded Et eksempel er kvalitetsmålet «andel manglende enheter» som handler om mangel. Det vil være for eksempel 2 % _mangel_ (negativt ladet) istedenfor 98 % _fullstendig_ (positivt ladet) som oppgis. Det er viktig å være klar over dette, både ved angivelse av verdier til kvalitetsmål og ved visning av verdiene i et sluttbrukergrensesnitt. I et konkret sluttbrukergrensesnitt kan man godt presentere det positivt (f.eks. regne om «2 % mangel» til «98 % fullstendig» og presentere resultatet positivt). === Fritekst kan brukes som supplerende forklaring -https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO (Norsk applikasjonsprofil av DQV)] tillater bruk av fritekst-kommentarer som supplerende forklaringer til en kvantifiserbar kvalitetsmåling. For eksempel, til vårt eksempeldatasett «Bygninger», hvis resultatet på kvalitetsmålet «andel enheter med manglende verdi for en gitt egenskap» er «2 %», kan man i fritekst-kommentaren spesifisere hvilken egenskap mangelen gjelder, for eksempel: «Dette gjelder egenskap ‘byggeår’». +https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO (Norsk applikasjonsprofil av DQV) ⧉, window="_blank", role="ext-link"] tillater bruk av fritekst-kommentarer som supplerende forklaringer til en kvantifiserbar kvalitetsmåling. For eksempel, til vårt eksempeldatasett «Bygninger», hvis resultatet på kvalitetsmålet «andel enheter med manglende verdi for en gitt egenskap» er «2 %», kan man i fritekst-kommentaren spesifisere hvilken egenskap mangelen gjelder, for eksempel: «Dette gjelder egenskap ‘byggeår’». -For de aller fleste brukstilfeller antok arbeidsgruppen som utarbeidet disse definisjonene, at det burde holde med supplerende fritekst-kommentarer. For avanserte kvalitetsbeskrivelser, for eksempel der det er behov for å avgi resultater for hver enkelt egenskap, er det i henhold til DQV mulig å oppgi slike resultater som egne datasett (https://www.w3.org/TR/vocab-dqv/#dqv:QualityMeasurementDataset[dqv:QualityMeasurementDataset]). For eksempel en «tabell» som sier «2 % mangel» for egenskap «byggeår», «3 % mangel» for egenskap «bruksareal» og «0 % mangel» for alle de andre egenskapene: +For de aller fleste brukstilfeller antok arbeidsgruppen som utarbeidet disse definisjonene, at det burde holde med supplerende fritekst-kommentarer. For avanserte kvalitetsbeskrivelser, for eksempel der det er behov for å avgi resultater for hver enkelt egenskap, er det i henhold til DQV mulig å oppgi slike resultater som egne datasett (https://www.w3.org/TR/vocab-dqv/#dqv:QualityMeasurementDataset[dqv:QualityMeasurementDataset ⧉, window="_blank", role="ext-link"]). For eksempel en «tabell» som sier «2 % mangel» for egenskap «byggeår», «3 % mangel» for egenskap «bruksareal» og «0 % mangel» for alle de andre egenskapene: [cols="50%,10%,10%,10%,10%,10%", stripes=odd] diff --git a/docs/innledning.adoc b/docs/innledning.adoc index f436856..68d8aba 100644 --- a/docs/innledning.adoc +++ b/docs/innledning.adoc @@ -4,16 +4,16 @@ Formålet med dette dokumentet er å gi veiledning i felles definisjoner på og måleverktøy for kvantifiserbar kvalitet på datasett. Et felles sett med definisjoner og måleverktøy vil skape en unison beskrivelse og forståelse av datakvalitet på tvers av virksomheter. Hensikten er ikke å utelukke andre måter å beskrive datakvalitet på enn disse presentert i dette dokumentet. Man står fritt til å supplere med andre typer kvalitetsmål i kvalitetsbeskrivelsen. -I henhold til https://data.norge.no/specification/spesifikasjon-for-beskrivelse-av-kvalitet-pa-datasett/[Spesifikasjon for beskrivelse av kvalitet på datasett], er det flere ulike måter å beskrive kvalitet på et datasett på: +I henhold til https://data.norge.no/specification/spesifikasjon-for-beskrivelse-av-kvalitet-pa-datasett/[Spesifikasjon for beskrivelse av kvalitet på datasett ⧉, window="_blank", role="ext-link"], er det flere ulike måter å beskrive kvalitet på et datasett på: * kvantifiserbar kvalitet * ikke-kvantifiserbar kvalitet * kvalitet i samsvar med gitt(e) standard(er)/spesifikasjon(er) * brukertilbakemeldinger knyttet til kvalitet -Spesifikasjonen foreslo også å predefinere kvalitetsdimensjoner, kvalitetsdeldimensjoner og kvalitetsmål. Disse er publisert som egne kontrollerte vokabularer, ett for https://data.norge.no/vocabulary/quality-dimension[kvalitets(del)dimensjoner] og ett for https://data.norge.no/vocabulary/quality-metric[kvalitetsmål]. +Spesifikasjonen foreslo også å predefinere kvalitetsdimensjoner, kvalitetsdeldimensjoner og kvalitetsmål. Disse er publisert som egne kontrollerte vokabularer, ett for https://data.norge.no/vocabulary/quality-dimension[kvalitets(del)dimensjoner ⧉, window="_blank", role="ext-link"] og ett for https://data.norge.no/vocabulary/quality-metric[kvalitetsmål ⧉, window="_blank", role="ext-link"]. -Dette er ikke en veileder for datakvalitetsarbeidet generelt. Veilederen forklarer hvordan datakvalitet beskrives, med fokus på å bruke predefinerte kvantifiserbare kvalitetsmål. Ved behov vil det bli utarbeidet tilsvarende veiledere for de andre måter å beskrive kvalitet på. Disse vil inngå i https://www.digdir.no/3626[Rammeverk for informasjonsforvaltning]. +Dette er ikke en veileder for datakvalitetsarbeidet generelt. Veilederen forklarer hvordan datakvalitet beskrives, med fokus på å bruke predefinerte kvantifiserbare kvalitetsmål. Ved behov vil det bli utarbeidet tilsvarende veiledere for de andre måter å beskrive kvalitet på. Disse vil inngå i https://www.digdir.no/3626[Rammeverk for informasjonsforvaltning ⧉, window="_blank", role="ext-link"]. === Målgruppe @@ -25,15 +25,15 @@ Målgruppen for veilederen er: === Sammenheng mellom relevante standarder, spesifikasjoner og denne veilederen -Veilederen må ses i sammenheng med https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO (Norsk applikasjonsprofil av DQV)]. +Veilederen må ses i sammenheng med https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO (Norsk applikasjonsprofil av DQV) ⧉, window="_blank", role="ext-link"]. image::images/sammenheng.png[] Tegningen ovenfor illustrerer sammenhengen mellom ulike standarder/spesifikasjoner og felles definisjoner: -* https://data.norge.no/specification/dcat-ap-no/[DCAT-AP-NO - Standard for beskrivelse av datasett, datatjenester og datakataloger]: Denne spesifiserer bl.a. hvordan datasett beskrives, deriblant hvordan en beskrivelse av kvantifiserbar kvalitet knyttes til beskrivelsen av et datasett. +* https://data.norge.no/specification/dcat-ap-no/["DCAT-AP-NO - Standard for beskrivelse av datasett, datatjenester og datakataloger ⧉", window="_blank", role="ext-link"]: Denne spesifiserer bl.a. hvordan datasett beskrives, deriblant hvordan en beskrivelse av kvantifiserbar kvalitet knyttes til beskrivelsen av et datasett. -* https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO - Norsk applikasjonsprofil av DQV]: Denne spesifiserer hvordan kvalitet på datasett beskrives, bl.a. å knytte kvalitetsbeskrivelse til kvalitetsdimensjon. +* https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO - Norsk applikasjonsprofil av DQV ⧉, window="_blank", role="ext-link"]: Denne spesifiserer hvordan kvalitet på datasett beskrives, bl.a. å knytte kvalitetsbeskrivelse til kvalitetsdimensjon. * Felles definisjoner: Hensikten med felles definisjoner er å skape et felles vokabular for kvalitetsbeskrivelse, slik at beskrivelsene forstås likt. Dette handler om felles definisjoner og forståelse av kvalitetsdimensjoner og kvalitetsdeldimensjoner, og også kvalitetsmål når det gjelder kvantifiserbar kvalitet. diff --git a/docs/main.adoc b/docs/main.adoc index 0a8e41e..9798552 100644 --- a/docs/main.adoc +++ b/docs/main.adoc @@ -29,7 +29,7 @@ image::images/Digdir.png[width=50%, pdfwidth=30vw, link=https://digdir.no/] include::shared/download.adoc[] NOTE: *Innmelding av feil og mangler:* + -Dersom du finner feil eller mangler i dokumentet, ber vi om at dette meldes inn på https://github.com/Informasjonsforvaltning/veileder-kvantifiserbar-kvalitet/issues[Github Issues]. Dersom du ikke allerede har bruker på Github kan du opprette bruker gratis. +Dersom du finner feil eller mangler i dokumentet, ber vi om at dette meldes inn på https://github.com/Informasjonsforvaltning/veileder-kvantifiserbar-kvalitet/issues[Github Issues ⧉, window="_blank", role="ext-link"]. Dersom du ikke allerede har bruker på Github kan du opprette bruker gratis. toc::[] diff --git a/docs/navnerom.adoc b/docs/navnerom.adoc index 5a8ff10..3d40cee 100644 --- a/docs/navnerom.adoc +++ b/docs/navnerom.adoc @@ -5,9 +5,9 @@ [cols="10,45,45"] |=== |*Prefiks*|*Navnerom*|*Forklaring/navn* -|dcat| `\http://www.w3.org/ns/dcat#` | https://www.w3.org/TR/vocab-dcat-2/[Data Catalog Vocabulary] -|dqv| `\http://www.w3.org/ns/dqv#` | https://www.w3.org/TR/vocab-dqv/[Data Quality Vocabulary] -|rdfs| `\http://www.w3.org/2000/01/rdf-schema#` | https://www.w3.org/TR/rdf-schema/[RDF Schema 1.1] |xsd| `\http://www.w3.org/2001/XMLSchema#` | https://www.w3.org/TR/xmlschema-2/[XML Schema Part 2: Datatypes Second Edition] +|dcat| `\http://www.w3.org/ns/dcat#` | https://www.w3.org/TR/vocab-dcat-2/[Data Catalog Vocabulary ⧉, window="_blank", role="ext-link"] +|dqv| `\http://www.w3.org/ns/dqv#` | https://www.w3.org/TR/vocab-dqv/[Data Quality Vocabulary ⧉, window="_blank", role="ext-link"] +|rdfs| `\http://www.w3.org/2000/01/rdf-schema#` | https://www.w3.org/TR/rdf-schema/[RDF Schema 1.1 ⧉, window="_blank", role="ext-link"] |xsd| `\http://www.w3.org/2001/XMLSchema#` | https://www.w3.org/TR/xmlschema-2/[XML Schema Part 2: Datatypes Second Edition ⧉, window="_blank", role="ext-link"] |=== Eksempel på prefiksene ovenfor uttrykt i RDF Turtle: diff --git a/docs/oversikt.adoc b/docs/oversikt.adoc index 009b879..f7aa964 100644 --- a/docs/oversikt.adoc +++ b/docs/oversikt.adoc @@ -8,21 +8,21 @@ Tabellen nedenfor gir en oversikt over de kvalitetsdimensjoner, kvalitetsdeldime [cols="25%,25%,50%"] |=== |*Kvalitetsdimensjon*|*Kvalitetsdeldimensjon*|*Kvalitetsmål* -.10+| https://data.norge.no/vocabulary/quality-dimension#completeness[fullstendighet] .5+| https://data.norge.no/vocabulary/quality-dimension#under-coverage[underdekning] | https://data.norge.no/vocabulary/quality-metric#qm-completeness-1001[manglende enheter] -| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1002[antall manglende enheter] -| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1003[andel manglende enheter] -| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1004[antall enheter med manglende verdi for en gitt egenskap] -| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1005[andel enheter med manglende verdi for en gitt egenskap] -.3+| https://data.norge.no/vocabulary/quality-dimension#over-coverage[overdekning] | https://data.norge.no/vocabulary/quality-metric#qm-completeness-2001[overflødige enheter] -| https://data.norge.no/vocabulary/quality-metric#qm-completeness-2002[antall overflødige enheter] -| https://data.norge.no/vocabulary/quality-metric#qm-completeness-2003[andel overflødige enheter] -.2+| https://data.norge.no/vocabulary/quality-dimension#imputation[imputering]| https://data.norge.no/vocabulary/quality-metric#qm-completeness-3001[antall enheter med imputert verdi for en gitt egenskap] -| https://data.norge.no/vocabulary/quality-metric#qm-completeness-3002[andel enheter med med imputert verdi for en gitt egenskap] -| https://data.norge.no/vocabulary/quality-dimension#currentness[aktualitet] | https://data.norge.no/vocabulary/quality-dimension#delay[tidsdifferanse] | https://data.norge.no/vocabulary/quality-metric#qm-currentness-1001[samlet tidsdifferanse] -.2+| https://data.norge.no/vocabulary/quality-dimension#consistency[konsistens] .2+| https://data.norge.no/vocabulary/quality-dimension#consistency-within-dataset[konsistens innad i datasett] | https://data.norge.no/vocabulary/quality-metric#qm-consistency-1001[andel enheter med inkonsistente egenskaper] -| https://data.norge.no/vocabulary/quality-metric#qm-consistency-1002[andel enheter med inkonsistens mellom gitte egenskaper] -.4+| https://data.norge.no/vocabulary/quality-dimension#accuracy[nøyaktighet] .2+| https://data.norge.no/vocabulary/quality-dimension#identifier-correctness[identifikatorriktighet] | https://data.norge.no/vocabulary/quality-metric#qm-accuracy-1001[antall enheter med identifikatorfeil] -| https://data.norge.no/vocabulary/quality-metric#qm-accuracy-1002[andel enheter med identifikatorfeil] -.2+| https://data.norge.no/vocabulary/quality-dimension#classification-correctness[klassifikasjonsriktighet] | https://data.norge.no/vocabulary/quality-metric#qm-accuracy-2001[antall feilklassifiserte enheter for en gitt egenskap] -| https://data.norge.no/vocabulary/quality-metric#qm-accuracy-2002[andel feilklassifiserte enheter for en gitt egenskap] +.10+| https://data.norge.no/vocabulary/quality-dimension#completeness[fullstendighet ⧉, window="_blank", role="ext-link"] .5+| https://data.norge.no/vocabulary/quality-dimension#under-coverage[underdekning ⧉, window="_blank", role="ext-link"] | https://data.norge.no/vocabulary/quality-metric#qm-completeness-1001[manglende enheter ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1002[antall manglende enheter ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1003[andel manglende enheter ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1004[antall enheter med manglende verdi for en gitt egenskap ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-completeness-1005[andel enheter med manglende verdi for en gitt egenskap ⧉, window="_blank", role="ext-link"] +.3+| https://data.norge.no/vocabulary/quality-dimension#over-coverage[overdekning ⧉, window="_blank", role="ext-link"] | https://data.norge.no/vocabulary/quality-metric#qm-completeness-2001[overflødige enheter ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-completeness-2002[antall overflødige enheter ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-completeness-2003[andel overflødige enheter ⧉, window="_blank", role="ext-link"] +.2+| https://data.norge.no/vocabulary/quality-dimension#imputation[imputering ⧉, window="_blank", role="ext-link"]| https://data.norge.no/vocabulary/quality-metric#qm-completeness-3001[antall enheter med imputert verdi for en gitt egenskap ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-completeness-3002[andel enheter med med imputert verdi for en gitt egenskap ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-dimension#currentness[aktualitet ⧉, window="_blank", role="ext-link"] | https://data.norge.no/vocabulary/quality-dimension#delay[tidsdifferanse ⧉, window="_blank", role="ext-link"] | https://data.norge.no/vocabulary/quality-metric#qm-currentness-1001[samlet tidsdifferanse ⧉, window="_blank", role="ext-link"] +.2+| https://data.norge.no/vocabulary/quality-dimension#consistency[konsistens ⧉, window="_blank", role="ext-link"] .2+| https://data.norge.no/vocabulary/quality-dimension#consistency-within-dataset[konsistens innad i datasett ⧉, window="_blank", role="ext-link"] | https://data.norge.no/vocabulary/quality-metric#qm-consistency-1001[andel enheter med inkonsistente egenskaper ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-consistency-1002[andel enheter med inkonsistens mellom gitte egenskaper ⧉, window="_blank", role="ext-link"] +.4+| https://data.norge.no/vocabulary/quality-dimension#accuracy[nøyaktighet ⧉, window="_blank", role="ext-link"] .2+| https://data.norge.no/vocabulary/quality-dimension#identifier-correctness[identifikatorriktighet ⧉, window="_blank", role="ext-link"] | https://data.norge.no/vocabulary/quality-metric#qm-accuracy-1001[antall enheter med identifikatorfeil ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-accuracy-1002[andel enheter med identifikatorfeil ⧉, window="_blank", role="ext-link"] +.2+| https://data.norge.no/vocabulary/quality-dimension#classification-correctness[klassifikasjonsriktighet ⧉, window="_blank", role="ext-link"] | https://data.norge.no/vocabulary/quality-metric#qm-accuracy-2001[antall feilklassifiserte enheter for en gitt egenskap ⧉, window="_blank", role="ext-link"] +| https://data.norge.no/vocabulary/quality-metric#qm-accuracy-2002[andel feilklassifiserte enheter for en gitt egenskap ⧉, window="_blank", role="ext-link"] |=== From dd550cdf7cc1398522d0b4ae1f0f72e9e0f2e3a6 Mon Sep 17 00:00:00 2001 From: jimjyang Date: Wed, 4 Dec 2024 08:49:30 +0100 Subject: [PATCH 5/5] Issue #17 (alternativ tekst til figurer) --- docs/hensyn.adoc | 2 +- docs/innledning.adoc | 3 ++- docs/main.adoc | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/hensyn.adoc b/docs/hensyn.adoc index 0daacbd..82fa833 100644 --- a/docs/hensyn.adoc +++ b/docs/hensyn.adoc @@ -8,7 +8,7 @@ Der det er relevant, finnes det predefinere kvalitetsmål for både enhet- og eg .Eksempeldatasett: Bygninger -image::images/eksempeldatasett.png[] +image::images/eksempeldatasett.png[alt="Tabell med et illustrativt datasett, som inneholder fire rader og seks kolonner."] === Predefinerte kvalitetsmål bruker negativt ladede ord diff --git a/docs/innledning.adoc b/docs/innledning.adoc index 68d8aba..bfb44ed 100644 --- a/docs/innledning.adoc +++ b/docs/innledning.adoc @@ -27,7 +27,8 @@ Målgruppen for veilederen er: Veilederen må ses i sammenheng med https://data.norge.no/specification/dqv-ap-no[DQV-AP-NO (Norsk applikasjonsprofil av DQV) ⧉, window="_blank", role="ext-link"]. -image::images/sammenheng.png[] +.Sammenheng mellom DCAT-AP-NO, DQV-AP-NO og felles definisjoner av kvalitets(del)dimensjoner og kvalitetsmål. +image::images/sammenheng.png[alt="Tegning som viser sammenheng mellom DCAT-AP-NO (venstredelen av tegning), DQV-AP-NO (midtredelen tegningen) og Felles definisjoner (høyredelen av tegningen)."] Tegningen ovenfor illustrerer sammenhengen mellom ulike standarder/spesifikasjoner og felles definisjoner: diff --git a/docs/main.adoc b/docs/main.adoc index 9798552..4f674f8 100644 --- a/docs/main.adoc +++ b/docs/main.adoc @@ -12,7 +12,7 @@ ifdef::backend-pdf[:toc: macro] :sectlinks: :title-logo-image: image:images/Digdir.png[pdfwidth=30vw] -image::images/Digdir.png[width=50%, pdfwidth=30vw, link=https://digdir.no/] +image::images/Digdir.png[alt="Digdir-logo", width=50%, pdfwidth=30vw, link=https://digdir.no/] //:sectnums: