Petter Schultz
1d85656e96
Tidligere refererte repoet til dokumentasjon som lå utenfor (i Salg/_mal/), og brukte Obsidian-wikilinks [[...]] som ikke er klikkbare i Gitea. Begge deler gjorde at lenker var døde i Gitea-web. Endringer: - Hentet inn arbeidsdokumentene som faktisk brukes under oppdraget: _metode/ (00-konvensjoner, 01-startklar-sjekkliste, 02-gjennomforing) artefakter/ (risikoregister, integrasjonslandskap, workshop-agenda, domenemodell-skjema) - Konverterte 82 Obsidian-wikilinks til standard markdown-lenker med korrekte relative stier — klikkbare både i Gitea og lokalt - Begrepsord i begrepskatalogen ([[Bedrift]] etc.) ble til ren tekst (de var aldri filer) - Oppdaterte konvensjonsdokumentet til å foreskrive standard markdown, ikke wikilinks (med begrunnelse: Gitea rendrer ikke [[...]]) - Oras/Kirken/salgsmateriale er nå tydelig merket som eksterne arbeidsområde-referanser (andre kunder / salgsfase), ikke dinglende lenker som lot som de var i repoet Verifisert: 133 ekte interne lenker resolver korrekt. De 4 gjenværende treffene i validering er kodeeksempler i backticks (viser lenke-syntaks), ikke faktiske lenker. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
125 lines
4.2 KiB
Markdown
125 lines
4.2 KiB
Markdown
---
|
|
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
|