sidelinja/server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
server/ops/doc-audit.md
vegard 8ca9832248 Legg til ops/ (vedlikeholdsjobber) og docs/retninger/ (arkitektoniske teser) 
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>
2026-03-17 04:54:17 +01:00

1.7 KiB
Raw Blame History

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å.