docs QA: mermaid diagrams rewritten + renderer-enforced in CI #3

2026-09-07T00:29:06Z

reachableceo commented

2026-09-07 00:29:06 +00:00

Founder QA catch: the architecture diagrams did not render (backslash-n escapes in node labels, semicolons as statement separators in sequence messages, braces in message text). All diagrams rewritten to conservative mermaid syntax and verified 3/3 PARSE-OK with mermaid-cli in a real renderer; CI now fails on unrenderable diagrams. no-CR (docs). Ticket: https://projects.knownelement.com/issues/832

reachableceo added 1 commit 2026-09-07 00:29:06 +00:00

docs QA: diagrams must parse in a real mermaid renderer

ci / vet (pull_request) Successful in 55s

Details

ci / diagrams (pull_request) Failing after 2m45s

Details

e3c8e43ffb

The first architecture set did not render (backslash-n escapes,
semicolons in sequence messages, braces in text). All diagrams
rewritten to conservative syntax and QA-verified with mermaid-cli
(3/3 PARSE-OK). qa-diagrams.sh added; CI enforces it on docs changes.

Ticket: https://projects.knownelement.com/issues/832

reachableceo merged commit 0a89b89392 into main

2026-09-07 00:29:08 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: KNEL/KNELSecretsManager#3