Files

Petter Schultz 1d85656e96 Gjør all dokumentasjon tilgjengelig i repo og fiks alle lenker

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>

2026-05-27 10:34:14 +02:00

4.2 KiB

Raw Permalink Blame History

title, date, tags, version

title

date

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:

---
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:

### 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:

## 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

4.2 KiB Raw Permalink Blame History