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>
This commit is contained in:
124
_metode/00-konvensjoner.md
Normal file
124
_metode/00-konvensjoner.md
Normal file
@@ -0,0 +1,124 @@
|
||||
---
|
||||
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
|
||||
Reference in New Issue
Block a user