Documentatie die zichzelf schrijft

Klik in de portal bij Omgevingen op Ontwikkeling, en daar op Openen. Flow opent in een nieuw tabblad, en u bent meteen ingelogd.

In de balk helemaal links staat Docs. Daar staan de ruimtes met hun pagina's, en waar ze naartoe publiceren. Een nieuwe werkruimte heeft nog geen ruimtes.

Klik op ＋ (Nieuwe ruimte) en kies bij Van module de module Orders. De naam neemt Flow over; kies de taal van de pagina's en de klasse. Na Aanmaken schrijft de ruimte zichzelf: een overzicht van de module, en een pagina per API, workflow en tabel, gemarkeerd met maakt zichzelf.

Open de pagina van de API. Bovenaan staat waaruit hij gemaakt is, met de versie. De grijze delen met het slotje komen uit Flow zelf: hoe u inlogt, de endpoints, wat ze doen en wie ze mag aanroepen, en een voorbeeld zonder echte gegevens. Rechts staat wat er nooit op zo'n pagina komt.

Onder elk deel staat Notitie toevoegen. Schrijf wat collega's moeten weten over het aanmaken van een order en klik op Opslaan. De notitie hangt vast aan dit endpoint: als de pagina zichzelf opnieuw schrijft, blijft hij staan.

Een bouwer gaf het endpoint een beschrijving en haalde het GET-endpoint weg. Open de pagina opnieuw: Flow maakt hem alleen opnieuw als zijn bron veranderde, en uw notitie staat nog op zijn plek. In Geschiedenis onderin staat Opnieuw gemaakt uit ….

De notitie bij het GET-endpoint had geen plek meer: Flow gooit hem niet weg maar zet hem in Losse notities, met de pagina en het deel waar hij bij hoorde. Lees hem, en zet de tekst waar hij nu hoort of haal hem weg.

Klik bij de ruimte op ＋ (Nieuwe pagina). Geef een titel en kies het sjabloon Runbook: het begint met een waarschuwing en de vaste kopjes. Na Aanmaken opent de pagina als concept.

Klik op Bewerken. Tot de nieuwe editor er is, schrijft u in Markdown: # voor een kop, - voor een lijst, en [[titel]] voor een verwijzing naar een andere pagina. Flow bewaart stil terwijl u typt. Klik op Klaar.

Rechts in de inspector staat de status: Concept. Lezers zien alleen wat u publiceert; klik op Publiceren. De API-pagina noemt het runbook nu onder Verwijst hiernaar.

Onderin staan bij een Docs-pagina Opmerkingen, Geschiedenis en Verwijzingen. Schrijf een opmerking en klik op Plaatsen; collega's antwoorden eronder en handelen hem af als het geregeld is.

Met MCP-toegang leest een AI-app zoals Claude Code de pagina's (list_spaces, get_page, search_docs) en schrijft hij concepten (draft_page) en uitleg bij een onderdeel (draft_note). Die uitleg staat gestippeld op de pagina als voorstel: lezers zien hem pas als een mens op Accepteren klikt.