Ga naar hoofdinhoud

60 — Portfolio Atlas

De kaart van het Ruimtemeesters-portfolio. Wat elke app is, hoe ze zich verhouden, waar hun docs staan, welke vocabulaire ze delen.

Dit is eigen inhoud van Documentatie: atlas-pagina's bestaan nergens anders en overschaduwen geen per-repo docs. Ze zitten erbovenop.

Wanneer wel

  • Een lezer moet weten welke apps er zijn en welke waarvoor is
  • Een begrip duikt in meerdere repos op en heeft één canonieke definitie nodig (woordenlijst)
  • Een cross-repo overdracht heeft een "hier woont elke kant"-wijzer nodig
  • Een diagram raakt meerdere apps en zou anders nergens leven

Wanneer niet

  • App-specifieke inhoud die al in de product-repo staat — link er gewoon naartoe
  • API-contracten en endpoint-referenties — die horen in 70-api-referentie/
  • Stap-voor-stap taakhandleidingen — die horen in 80-handleidingen/
  • De verhouding tussen Documentatie en Processen — dat is visie (00-visie/)

Wat hier staat

Een handvol vaste pagina's, plus onderwerp-specifieke atlas-pagina's naar behoefte:

BestandDoel
portfolio-map.mdDe lijst apps met één-alinea beschrijvingen en links naar elke repo
woordenlijst.mdCross-repo vocabulaire (BOPA, thema, toetsing, gemeente, AKN, …)
waar-staat-x.mdSnelle lookup: "Ik zoek X — welke repo open ik?"
<onderwerp>-atlas.mdAlles dat baat heeft bij het vogelvluchtperspectief

Bestandspatroon

<onderwerp>-atlas.md, of een van de vaste bestandsnamen hierboven. Hou slugs kort.

Statuswaarden

StatusBetekenis
ConceptWordt geschreven
ActueelReflecteert het portfolio zoals het nu is
VerouderdLoopt aantoonbaar achter; gemarkeerd voor refresh

Sjabloon

# <Onderwerp> — Portfolio Atlas

**Laatst bijgewerkt:** YYYY-MM-DD
**Status:** Concept | Actueel | Verouderd

## Doel

(Eén alinea. Welke vraag beantwoordt deze pagina voor de lezer.)

## De kaart

(Tabel, diagram of korte lijst. Hou het scanbaar — atlas-pagina's leven of sterven met leesbaarheid op een blik.)

## Per-app wijzers

| App | Wat daar staat | Link |
|---|---|---|
| | | |

## Gerelateerd

- Referentie: [[referentie-pagina]]
- Handleiding: [[handleiding-pagina]]
- Visie: [[documentatie-visie]]