vegard
8ca9832248
Ny mappe ops/ med repeterbare vedlikeholdsjobber: - ryddejobb.md — full prosjektrevisjon - doc-audit.md — docs vs kode - drift-sjekk.md — prod vs lokal vs docs Ny mappe docs/retninger/ med arkitektoniske teser: - status_quo.md — hva Sidelinja er i dag - rom_ikke_forum.md — opplevelse-først, to-lags-modell, administrativ opplevelse - universell_input.md — tre primitiver (input, mottak, kommunikasjon), noder+edges - maskinrommet.md — Rust-orkestrator, edge-drevet ressursorkestrering, CAS+pruning - bruker_ikke_workspace.md — brukeren er sentrum, workspaces er samlings-noder - datalaget.md — PG+Apache AGE, SpacetimeDB som sanntidslag, lagmodell Oppdatert CLAUDE.md og proposals/README.md med referanser. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
46 lines
1.7 KiB
Markdown
46 lines
1.7 KiB
Markdown
# Doc-audit — Dokumentasjon vs kode
|
|
|
|
## Hva
|
|
Målrettet gjennomgang av `docs/`-treet for å sikre at dokumentasjonen stemmer med
|
|
faktisk kode. Mer fokusert enn ryddejobben — kun docs.
|
|
|
|
## Når
|
|
- Månedlig som rutine
|
|
- Etter store refaktoreringer eller arkitekturendringer
|
|
- Når nye docs legges til
|
|
|
|
## Sjekkliste
|
|
|
|
### 1. Filreferanser
|
|
- [ ] Sjekk alle filstier nevnt i docs — eksisterer de?
|
|
- [ ] Sjekk alle komponent-/modul-navn nevnt i docs — eksisterer de i koden?
|
|
- [ ] Sjekk alle route-referanser — matcher de `web/src/routes/`?
|
|
|
|
### 2. CLAUDE.md doc-tre
|
|
- [ ] Er alle filer i `docs/` listet i CLAUDE.md doc-treet?
|
|
- [ ] Er det filer listet i CLAUDE.md som ikke eksisterer?
|
|
- [ ] Er beskrivelsene i doc-treet fortsatt dekkende?
|
|
|
|
### 3. Tekniske detaljer
|
|
- [ ] Stemmer database-skjema beskrevet i docs med faktiske migrasjoner?
|
|
- [ ] Stemmer API-endepunkter beskrevet i docs med faktiske routes?
|
|
- [ ] Stemmer SpacetimeDB-tabeller/reducere i docs med modulen?
|
|
|
|
### 4. Setup-docs
|
|
- [ ] `docs/setup/lokal.md` — fungerer stegene fortsatt?
|
|
- [ ] `docs/setup/produksjon.md` — stemmer med faktisk server-oppsett?
|
|
- [ ] `docs/setup/migration_safety.md` — er sjekklisten oppdatert?
|
|
|
|
### 5. Proposals
|
|
- [ ] Er noen proposals implementert og bør flyttes til `concepts/` eller `features/`?
|
|
- [ ] Er noen proposals foreldet og bør slettes eller arkiveres?
|
|
- [ ] Er noen proposals egentlig retningsspørsmål og bør flyttes til `retninger/`?
|
|
|
|
### 6. Retninger
|
|
- [ ] Er tesene i `docs/retninger/` fortsatt relevante?
|
|
- [ ] Har noen retninger modnet nok til å påvirke andre docs (arkitektur, features, infra)?
|
|
- [ ] Er det nye arkitektoniske spenninger som fortjener en egen retning?
|
|
|
|
## Sist kjørt
|
|
|
|
_Ikke kjørt ennå._
|