Vi innfører en beslutningprosess som baserer seg på beslutningsdokumenter i Markdown og merge requests i GitLab.

Markdown-dokumentet skal følge CommonMark-spesifikasjonen. I tillegg skal dokumentet inneholde en strukturert innledningsblokk i YAML med metadata som gjør det enkelt å automatisere publisering med mer. Beslutningsdokumentene skal ligge i beslutninger-katalogen. Innholdet i denne katalogen skal være offentlig tilgjengelig og synliggjøres i en offentlig tilgjengelig beslutningslogg.

Detaljert beskrivelse av prosessen bor i README-filen, slik at denne kan endres og forbedres, uten at det må fattes en ny beslutning. Vi kan fryse prosessen i en ny beslutning senere, dersom dette viser seg å være mer hensiktsmessig.

Kontekst

I forbindelse med moderniseringen av FS så har det blitt tatt mange viktige beslutninger. Hvor og hvordan disse beslutningene blir vedtatt og kommunisert har frem til nå vært noe vilkårlig. Dette er ineffektivt som følge av at man:

1. bruker tid på å diskutere avgjørelser som raskt kunne blitt fattet gitt en god prosess
2. bruker tid på å diskutere avgjørelser som allerede er blitt fattet

Ytre påvirkninger

FS utvikles av Produktområde FS i Divisjonen for Utdanning og Administrasjon i Sikt. Her jobbes det med å etablere en felles prosess for beslutninger på divisjonsnivå. Prosessen vi etablerer her må forholde seg til denne felles prosessen. Dette innebærer at:

1. Vi må kunne forbedre og endre prosessen underveis.
2. Man må kunne lenke fra beslutninger som skjer på divisjonsnivå til beslutninger som blir gjort i FS-plattformen.
3. Man må kunne lenke fra beslutninger som skjer i FS-plattformen til beslutninger som blir gjort på divisjonsnivå.
4. Beslutningsloggen i FS-plattformen må lenke til beslutningsloggen på divisjonsnivå.
5. Beslutningsloggen på divisjonsnivå må lenke til beslutningsloggen i FS-plattformen.

Konsekvenser

Den resulterende beslutningskatalogen kan gjenbruke arbeidet som er lagt ned rundt prosesskatalogen og begrepskatalogen. Den vil dermed automatisk publiseres til FS-plattformen slik at alle (både interne og eksterne) raskt kan se hvilke beslutninger som er gjeldende og forstå konteksten som lå til grunn for beslutningen.

Utviklere er allerede godt kjent med bruk av merge requests som samhandlingsverktøy. Ikke-utviklere er allerede i gang med å sette seg inn i disse verktøyene i forbindelse med arbeidet rundt prosess- og begrepskatalogen. Erfaringene så langt er at dette fungerer godt og fasiliterer gode diskusjoner mellom både utviklere og fagpersoner.

Bruk av versjonskontroll gjør det enkelt å finne ut hvem som står bak beslutningsdokumentet, dato for når dokumentet har blitt opprettet/endret.

Bruk av Markdown med metadata gjør det enkelt å bygge videre automatiseringer på toppen av denne løsningen.