---
title: "Konvensjoner — Startklar-malverk"
date: "2026-05-21"
tags: ["konvensjoner", "frontmatter", "metode"]
version: 1
---

# Konvensjoner

Felles konvensjoner for alle dokumenter i et oppdrag som bruker dette malverket. Arvet og generalisert fra Den norske kirke-oppdraget.

## Frontmatter

Alle leveranse- og analysedokumenter skal ha YAML-frontmatter:

```yaml
---
title: "Dokumenttittel — Kundenavn"
date: "YYYY-MM-DD"
source: "Kilder dokumentet bygger på (komma-separert)"
tags: ["tag1", "tag2"]
refs:
  - "relativ/sti/til/relatert-dokument.md"
qa:
  status: "draft | final-candidate | needs-fix"
  reviewed_on: "YYYY-MM-DD"
  reviewer: "Navn eller rolle"
version: 1
---
```

**Status-verdier:**
- `draft` — under arbeid
- `final-candidate` — klar for sluttgjennomgang
- `needs-fix` — funn å adressere

For mindre interne arbeidsdokumenter (intervjunotater, hypoteseskisser) kan frontmatter forenkles til kun `title`, `date`, `tags`.

## ID-system

Strukturerte ekstrakter får IDer slik at de kan refereres på tvers av dokumenter:

| Prefiks | Type | Eksempel |
|---|---|---|
| `DEC-YYYY-XXX` | Beslutning | DEC-2026-005 |
| `ACT-YYYY-XXX` | Handling | ACT-2026-012 |
| `RISK-YYYY-XXX` | Risiko | RISK-2026-003 |

**Format:** ID + tittel, deretter strukturerte felter:

```markdown
### DEC-2026-005 — Bedrift som master-entitet ligger i Business Central

**Dato:** 2026-06-03
**Kilde:** Kickoff med Standard Online + Standard Digital
**Status:** Bekreftet
**Konsekvens:** SuperOffice og nopCommerce konsumerer; ingen skriving direkte i CRM/nettbutikk.
```

ID-numre allokeres fortløpende per type per år. Sjekk eksisterende dokumenter for siste brukte nummer før nytt ID utstedes.

## Citation-format

Når du refererer til kildemateriale:

| Kildetype | Format | Eksempel |
|---|---|---|
| Markdown | `sti/til/fil.md#L12-L34` | `3.system-og-datalandskap/hovedsystemer.md#L42-L58` |
| DOCX | `docx:avsnitt-N-M` eller `docx:side-N` | `oppdragsbeskrivelse.docx:avsnitt-3-5` |
| PDF | `pdf:side-N` | `Startklar.pdf:side-1` |
| Ekstern URL | Full URL i lenke | `[Tittel](https://...)` |
| Møte | Dato + tema | `Møte 2026-06-03: Kickoff` |

Lenker til andre dokumenter i samme oppdrag bruker **standard markdown med relativ sti**: `[masterdata-og-eierskap](../4.informasjonsarkitektur/masterdata-og-eierskap.md)`. Vi bruker IKKE Obsidian-wikilinks `[[...]]` — de er klikkbare i Obsidian lokalt, men Gitea rendrer dem ikke som lenker. Standard markdown fungerer i begge. Relative stier fungerer både i Gitea-web og lokalt så lenge målet ligger inne i repoet.

## ANTAKELSE-markering

Når du formulerer noe basert på begrenset informasjon, marker det eksplisitt:

```
ANTAKELSE: Bedriftsdata i SuperOffice er kanonisk for kundetjenesten, men ikke for fakturering. conf: moderat
```

Confidence-nivåer:
- **lav** — gjetning basert på kontekst, må verifiseres
- **moderat** — basert på indirekte informasjon, sannsynlig korrekt
- **høy** — basert på direkte kilde, men ikke formelt bekreftet

Bekreftede fakta trenger ingen markering.

## Datoformat

ISO 8601 alltid: `YYYY-MM-DD` (f.eks. `2026-05-21`). Aldri `21.05.2026` eller `21/5-26`.

## Språk

Norsk Bokmål er standard. Engelsk for kundefasade ved internasjonale kunder (avklares i `01-startklar-sjekkliste.md`).

## Versjonering

`version: N` i frontmatter inkrementeres ved hver meningsfull endring etter første ferdigstilling. Mindre rettinger trenger ikke version-bump. Bruk `endringslogg`-seksjon nederst i dokumenter som endrer seg ofte:

```markdown
## Endringslogg

| Versjon | Dato | Endring | Forfatter |
|---|---|---|---|
| 1 | 2026-06-03 | Første utkast | Ragnhild |
| 2 | 2026-06-10 | Lagt til SuperOffice-avhengighet | Ragnhild |
```

## Klassifisering

Alle leveranser klassifiseres nederst:

- **Åpen** — kan deles eksternt
- **Begrenset** — kun for kunden og Forte-teamet (default)
- **Konfidensiell** — kun for navngitte personer

## Filnavn

- Bruk bindestrek, ikke understrek: `masterdata-og-eierskap.md`, ikke `masterdata_og_eierskap.md`
- Æ/Ø/Å erstattes med ae/oe/aa i filnavn for kompatibilitet: `kontinuerlig-laering`, ikke `kontinuerlig-læring`
- Datert prefix kun når relevant: `2026-06-03-kickoff.md` for møtenotater