Voeg ABB-documentatie voor de datacenterlaag en ArchiMate-skills toe #2

Merged
Arre.Zuurmond2 merged 1 commit from convert-abbs-to-markdown-abb-format into main 2026-10-15 09:15:19 +00:00
Collaborator

Wijziging

Voegt Markdown-documentatie toe voor de zes ABB's van de datacenterlaag, met metadata, Mermaid-diagrammen en de beschikbare oorspronkelijke ontwerptekst. Een laagrapportage legt de modeldekking en bevindingen vast: Datacenter Module is alleen afgebeeld in het ontwerp en Rack heeft geen ABB-specifieke ontwerptekst.

De repository bevat daarnaast de doorontwikkelde skill archimate-abb-markdown, de oorspronkelijke GitHub-skill archimate-xmi-basic en een aanroepscript voor generatie en validatie. Rapportages worden per laag bijgewerkt met behoud van aanvullende notities en bevindingen over andere ABB's.

Validatie

  • Tien regressietests voor tekstbehoud, metadata, modeldekking, verwijzingen en herhaalbaarheid.
  • Aanvullende controles voor behoud van rapportagenotities en bevindingen bij deelconversies.
  • De zes Mermaid-diagrammen zijn lokaal gerenderd en de skills zijn gevalideerd.
  • git diff --cached --check en expliciete controle dat geen bestanden uit input/ zijn opgenomen.

Bekende beperking: input niet opgenomen

De volledige inhoud van input/ is bewust uitgesloten van deze commit en wordt via .gitignore genegeerd. De oorspronkelijke Word- en XML-bestanden, de geconverteerde bron-Markdown en de bijbehorende afbeeldingen worden niet meegestuurd.

Hierdoor werken de verwijzingen naar afbeeldingen in de ABB-documenten niet in de repository en dit merge request. Ook de ontwerpbronlinks verwijzen naar de niet meegeleverde inputbestanden. De ingebedde Mermaid-diagrammen blijven beschikbaar. Voor opnieuw genereren en uitvoeren van de brongerichte tests moet de input lokaal beschikbaar zijn.

## Wijziging Voegt Markdown-documentatie toe voor de zes ABB's van de datacenterlaag, met metadata, Mermaid-diagrammen en de beschikbare oorspronkelijke ontwerptekst. Een laagrapportage legt de modeldekking en bevindingen vast: Datacenter Module is alleen afgebeeld in het ontwerp en Rack heeft geen ABB-specifieke ontwerptekst. De repository bevat daarnaast de doorontwikkelde skill `archimate-abb-markdown`, de oorspronkelijke GitHub-skill `archimate-xmi-basic` en een aanroepscript voor generatie en validatie. Rapportages worden per laag bijgewerkt met behoud van aanvullende notities en bevindingen over andere ABB's. ## Validatie - Tien regressietests voor tekstbehoud, metadata, modeldekking, verwijzingen en herhaalbaarheid. - Aanvullende controles voor behoud van rapportagenotities en bevindingen bij deelconversies. - De zes Mermaid-diagrammen zijn lokaal gerenderd en de skills zijn gevalideerd. - `git diff --cached --check` en expliciete controle dat geen bestanden uit `input/` zijn opgenomen. ## Bekende beperking: input niet opgenomen De volledige inhoud van `input/` is bewust uitgesloten van deze commit en wordt via `.gitignore` genegeerd. De oorspronkelijke Word- en XML-bestanden, de geconverteerde bron-Markdown en de bijbehorende afbeeldingen worden niet meegestuurd. **Hierdoor werken de verwijzingen naar afbeeldingen in de ABB-documenten niet in de repository en dit merge request.** Ook de ontwerpbronlinks verwijzen naar de niet meegeleverde inputbestanden. De ingebedde Mermaid-diagrammen blijven beschikbaar. Voor opnieuw genereren en uitvoeren van de brongerichte tests moet de input lokaal beschikbaar zijn.

@daniel.palstra Nice goed werk volgens mij is dit precies de kant die we op willen. Zo kunnen we input uit het ontwerp goed meenemen naar de volgende stappen!

@daniel.palstra Nice goed werk volgens mij is dit precies de kant die we op willen. Zo kunnen we input uit het ontwerp goed meenemen naar de volgende stappen!
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
NDSCloud/nds-cloud-architectuur!2
No description provided.