Vedligehold af dokumentation på Confluence

Registermyndigheder, der udstiller data på Datafordeleren, har tilsvarende dokumentation under det pågældende register under Dataoversigt.

Denne siden beskriver, hvordan registre får opdateret dokumentationen gennem Datafordeleroperatøren.

Registre kan også vælge at få rettigheder til at redigere sider i Datafordelerens Dokumentation.

Retningslinjerne for registre, som vælger selv at redigere dokumentation på Confluence, er beskrevet nedenfor.

Opdatering via Datafordeleroperatøren

Rettelser og opdateringer til dokumentationen kommer normalt ind til Datafordeleroperatøren via følgende kanaler:

• I forbindelse med releases hos Datafordeleren, hvor enten eksisterende dokumentation skal opdateres, eller ny dokumentation skal tilføjes
• Anvendere melder sager ind gennem supporten, som kræver opdatering/revidering af dokumentation 
• Registre melder selv rettelser ind til Datafordeleroperatøren, for eksempelvis via en request i Jira

Afklaringer om opdateringer sker i samarbejde mellem Datafordeleroperatøren og registrene inden at dokumentationen publiceres ud mod anvendere af Datafordeleroperatøren.

Hvilke sider kan registret få redigeringsrettigheder til

Overordnede sider

Der tildeles ikke rettigheder til de overordnede registersider, dette omfatter følgende:

• registrets hovedside, samt tilhørende side om Datakvalitet. Dette  er tilsammen en varedeklaration for registrets data. Informationen er udarbejdet af Grunddata Arkitekturforum og Modelsekretariatet i samarbejde med registrene.  
• side om bitemporalitet for registret
• skema-sider, der udstiller enkelte skemaer fra registrets dataleverancespecifikationen

Tjenestesider

Der kan tildeles redigeringsadgang efter behov til sider med registerspecifik dokumentation om tjenesterne, eksempelvis fildownload og GraphQL.

Adgange opryddes løbende, det vil sige at en registeradgang bibeholdes ikke efter en specifik opdatering.

Eksempel- og forretningssider

Der kan tildeles fast redigeringsadgang til registrets egne sider med eksempler, forretningsregler og datarettelser, samt side om kendte fejl og lignende sider.

Datafordeleroperatøren forbeholder sig dog retten til at foretage justeringer i layout og tekst, for at sikre et ensartet layout og sprog i dokumentationen.

Nye sider i strukturen

Ønsker et register at tilføje nye sider i registerdokumentationen, skal de rette henvendelse til Datafordeleroperatøren, som kan oprette nye sider. Registret må ikke selv oprette eller kopierer sider på Confluence.

Dette skyldes opsætning af rettigheder til siderne, og for at sikre et ensartet layout i dokumentationen.

Henvendelse om nye sider skal ske til Datafordeleroperatøren, for eksempelvis via en request i Jira