Stap 4. Documentatie en generatie

PDM FaseDocumentatie & Generatie PDM ValidatieOplevervalidatie

Details

Vertaal het PDM Canvas naar de fysieke mappenstructuur. Gebruik PDM-macro’s en de Hugo-compiler om dynamische Projecties programmatisch te genereren.

Waarom deze stap belangrijk is

In Stap 4 wordt de geanalyseerde netwerkstructuur omgezet naar een fysieke, bestand-gebaseerde publicatie. Hierbij passen we de technische inrichting toe: data (de SSoT in Markdown) wordt strikt gescheiden van de presentatie (layouts en macro’s).

Wat ga je doen?

  1. Mappenstructuur vullen: Vertaal de bouwstenen van het PDM Canvas naar platte Markdown-bestanden in de juiste fysieke mappenstructuur.
  2. PDM-macro’s inzetten: Gebruik PDM-shortcodes en macro’s in de Markdown-bronnen om onderlinge relaties en overzichten dynamisch in te laden.
  3. Publicatie genereren: Laat de Hugo-compiler de bronbestanden omzetten naar een razendsnelle, mobielvriendelijke website.

Stappenplan voor documentatie en generatie

1. Plaats de Markdown-bestanden in de mappenstructuur

Richt de lokale mappen op je harde schijf in en koppel de YAML-frontmatter aan de afgesproken attributen.

2. Gebruik PDM-macro’s voor dynamische Projecties

Kopieer geen informatie, maar laat de presentatielaag het werk doen via de ingebouwde PDM-macro’s:

  • {{ < toon-bouwsteen > }} / {{ < toon-attributen > }}: Rendert de specifieke bouwsteeneigenschappen en relaties.
  • Projecties genereren: Genereer automatisch de Flow-view, Rollenmatrix, RACI Matrix, Risicomatrix, Ketenimpact en het Kaderoverzicht.
3. Voer de Oplevervalidatie uit

Voer de Oplevervalidatie uit, waarbij de gegenereerde site met de Hugo-compiler op technische integriteit (geen gebroken links) gecontroleerd wordt en voer een doelgroeptoets uit op de werkvloer.

Volgende stap: Borging

Nu de PDM-omgeving gegenereerd is, veranker je het beheer en de overdracht naar de lijnorganisatie.

Naar Stap 5: Borging