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:
| Bestand | Doel |
|---|---|
portfolio-map.md | De lijst apps met één-alinea beschrijvingen en links naar elke repo |
woordenlijst.md | Cross-repo vocabulaire (BOPA, thema, toetsing, gemeente, AKN, …) |
waar-staat-x.md | Snelle lookup: "Ik zoek X — welke repo open ik?" |
<onderwerp>-atlas.md | Alles dat baat heeft bij het vogelvluchtperspectief |
Bestandspatroon
<onderwerp>-atlas.md, of een van de vaste bestandsnamen hierboven. Hou slugs kort.
Statuswaarden
| Status | Betekenis |
|---|---|
| Concept | Wordt geschreven |
| Actueel | Reflecteert het portfolio zoals het nu is |
| Verouderd | Loopt 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]]