Initial curated itworx-knowledge-hub source from 3b1751d0d9dee551aa6994eee0093704dc334817

docs/guides/pagina-s-schrijven-en-beheren.md

@@ -0,0 +1,98 @@
+# Pagina's schrijven, bewerken en beheren
+
+Deze gids beschrijft de M2-functionaliteit: de kennisboom, pagina's aanmaken en
+bewerken, sjablonen, interne links, concepten (autosave) en de prullenbak. Geschreven
+voor redacteuren en beheerders die dagelijks inhoud beheren.
+
+## De kennisboom
+
+- De kennisboom staat links in de zijbalk en toont eerst alleen de hoofdpagina's.
+  Onderliggende pagina's worden pas opgehaald wanneer u een tak openklapt — ook een
+  boom met tienduizenden pagina's blijft zo direct bruikbaar.
+- Klik op een pagina om ze te openen. Klik op het driehoekje om een tak met
+  subpagina's open of dicht te klappen.
+- Op een smal (mobiel) scherm is de zijbalk standaard verborgen. Gebruik de
+  knop "Navigatie" bovenaan om de kennisboom en de knop "Nieuwe pagina" te openen; ze
+  sluit automatisch zodra u een pagina kiest, zodat er op mobiel altijd maar één
+  hoofdvenster tegelijk zichtbaar is.
+
+## Een pagina aanmaken
+
+1. Klik op **Nieuwe pagina** (zijbalk, of via **Subpagina maken** op een bestaande
+   pagina om er meteen een onderliggende pagina van te maken).
+2. Vul een titel in.
+3. Kies optioneel een **sjabloon**: Studienotitie, Runbook, Architectuurbeslissing
+   (ADR) of Probleemoplossing. Een sjabloon vult de inhoud met een bruikbare
+   startstructuur; u kunt die nadien vrij aanpassen. Kiest u geen sjabloon, dan schrijft
+   u vrije Markdown-inhoud.
+4. Klik op **Pagina publiceren**.
+
+Een nieuwe pagina is direct zichtbaar voor iedereen met leesrechten op die plaats in de
+boom.
+
+> **V2-R1-update (2026-08-03):** voegt u vóór de eerste publicatie een bijlage toe aan
+> een nieuwe pagina (via de werkbalk of door een bestand in de editor te slepen), dan
+> gebeurt dat nu volledig veilig: het bestand wordt meteen definitief opgeslagen en op
+> de cursorpositie ingevoegd, en pas bij **Publiceren** wordt de pagina in één stap
+> zichtbaar — inclusief alle al toegevoegde bijlagen. Mislukt een upload, dan blijft de
+> pagina onzichtbaar en kunt u het gewoon opnieuw proberen; eerder gelukte bijlagen
+> gaan niet verloren. Er bestaat dus geen tussentoestand meer met een zichtbare pagina
+> en een kapotte bijlagelink. Zie `docs/adr/ADR-025-v2-r1-data-integrity-remediation.md`.
+
+## Een pagina bewerken
+
+1. Open de pagina en klik op **Bewerken**.
+2. Pas titel, inhoud, documenttype of status aan.
+3. Klik op **Wijzigingen publiceren**.
+
+Elke publicatie verhoogt de revisie van de pagina. De vorige inhoud blijft bewaard —
+volledige revisiegeschiedenis met terugzetten volgt in M3.
+
+### Versieconflicten
+
+Als iemand anders de pagina publiceerde terwijl u aan het bewerken was, toont de
+toepassing dat expliciet in plaats van de wijziging van de ander stilzwijgend te
+overschrijven: u kiest dan tussen **Gebruik gepubliceerde versie** (uw bewerkvenster
+wordt bijgewerkt met de nieuwste inhoud) of **Behoud mijn versie (overschrijven)** (uw
+tekst wordt alsnog gepubliceerd, bovenop de nieuwste revisie). Niets gaat verloren: uw
+getypte tekst blijft zichtbaar totdat u zelf kiest.
+
+## Concepten (automatisch opslaan)
+
+Terwijl u schrijft, wordt uw werk enkele seconden na elke wijziging automatisch
+opgeslagen als een persoonlijk concept — zichtbaar alleen voor uzelf, nooit voor andere
+gebruikers, en het overschrijft nooit de gepubliceerde pagina. Sluit u de browser per
+ongeluk of navigeert u weg, dan biedt de toepassing bij het opnieuw openen van de
+bewerkpagina aan om dat concept terug te laden.
+
+## Interne links
+
+Verwijs naar een andere pagina met dubbele blokhaken en de paginatitel:
+`[[Titel van de doelpagina]]`. Bij publicatie herkent de toepassing deze verwijzing en
+koppelt ze aan de betreffende pagina — niet aan de tekst. Wordt de doelpagina later
+hernoemd of verplaatst, dan blijft de link naar dezelfde pagina wijzen.
+
+- Bestaat er geen pagina met die titel, of zijn er meerdere pagina's met dezelfde titel,
+  dan blijft de tekst gewoon zichtbaar als platte tekst (`[[Titel]]`) in plaats van een
+  klikbare link — er wordt nooit een kapotte of verkeerde link gemaakt.
+- Gebruik `[[Titel|Zichtbare tekst]]` om een andere weergavetekst dan de paginatitel te
+  tonen.
+
+## Pagina's verplaatsen, ordenen, naar de prullenbak en herstellen
+
+- Een pagina naar de prullenbak verplaatsen kan via **Naar prullenbak** op de
+  paginaweergave. De pagina verdwijnt uit de kennisboom, maar wordt niet definitief
+  verwijderd.
+- **Herstellen** haalt een pagina terug uit de prullenbak.
+- Een pagina in de prullenbak kan niet bewerkt worden totdat ze hersteld is.
+- Verplaatsen tussen ouders en herordenen tussen zusterpagina's gebeurt via de API
+  (`POST /api/v1/pages/{pageId}/move`); een sleep-en-neerzet-interactie in de zijbalk is
+  nog niet gebouwd en volgt in een latere verfijning.
+
+## Toegankelijkheid
+
+Elke actie in dit hoofdstuk — pagina's aanmaken, bewerken, publiceren, naar de
+prullenbak verplaatsen, herstellen en tussen schrijf-/voorbeeldweergave wisselen — is
+volledig met het toetsenbord te bedienen en voldoet aan WCAG 2.2 AA (geverifieerd met
+axe-core tegen de echte, draaiende toepassing, op zowel een desktop- als een
+mobiel-viewport).