Ga naar hoofdinhoud

00 — Visie

De noordster voor wat Ruimtemeesters Documentatie is — en, als overlay, hoe het hele product-portfolio zich verhoudt. Visie-documenten zijn zeldzaam en langzaam bewegend. De meeste maanden levert deze map nul nieuwe documenten op.

Reikwijdte in Documentatie​

Twee soorten visies horen hier:

  • De eigen visie van deze repo — documentatie-visie.md. Eén, nooit twee.
  • Portfolio-overlays — één-pagina samenvattingen die per app naar de visie in die product-repo linken (bijv. portfolio-visie.md). De volledige visie van een app blijft in de product-repo.

Een visie voor één app schrijf je hier dus niet — die hoort in de repo van die app.

Wanneer wel​

  • De richting van het portfolio verschuift op een manier waar overlays op moeten aansluiten
  • Een nieuwe app komt in beeld en heeft een plek nodig in het portfolio-overzicht
  • Een bestaande overlay-visie wordt achterhaald door een product-repo

Bestandspatroon​

<onderwerp>-visie.md — bijv. documentatie-visie.md, portfolio-visie.md.

Sjabloon​

# <Onderwerp> Visie

**Laatst bijgewerkt:** YYYY-MM-DD
**Anker:** (link naar een hoger gelegen visie indien dit een sub-visie is)

## Waarom dit document bestaat

(Eén alinea: wat was onduidelijk vóór dit document, welke beslissingen worden er nu mogelijk door.)

## Wat <onderwerp> is

(Eén alinea: de zelfstandig-naamwoord-definitie. Lukt het niet in twee zinnen, dan is de scope nog niet helder.)

## De kerngebruiker

(Voor wie. Wees specifiek — "ontwikkelaars" is meestal te breed.)

## Pijnpunten die deze visie adresseert

1.
2.
3.

## De komende 6–12 maanden

(Wat we vastleggen. Bullets, geen alinea's.)

## Niet-doelen

(Wat deze visie expliciet *niet* op zich neemt.)