Vedligehold af dokumentation på Confluence

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

Denne side 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.

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

Principper for vedligehold af dokumentation i Confluence

1. Som udgangspunkt er det Datafordeleroperatøren der opretter og vedligeholder dokumentationen i Confluence
2. Du kan efter aftale få midlertidig adgang til at redigere en side
3. I enkelte tilfælde kan du blive tildelt rollen som redaktør på en side 

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 dokumentationen publiceres ud mod anvenderne.

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

Du kan få tildelt midlertidig adgang til at redigering sider med registerspecifik dokumentation om tjenesterne, eksempelvis fildownload og GraphQL.

Datafordeleroperetøren oprydder adgange løbende, det vil sige, at en registeradgang bibeholdes ikke efter en specifik opdatering.

Eksempel- og forretningssider

Du kan få tildelt redaktørrolle til registrets egne sider med eksempler, forretningsregler og datarettelser, samt side om kendte fejl og lignende sider.

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

Nye sider i strukturen

Ønsker I at få tilføjet nye sider i registerdokumentationen, skal I rette henvendelse til Datafordeleroperatøren, som opretter 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.