mirror of
https://github.com/shankar0123/certctl.git
synced 2026-06-07 14:01:36 +00:00
shankar0123
7d48bd0367
GitHub's mermaid renderer (older version) doesn't accept <br/> tags
or em-dashes in stateDiagram-v2 transition labels. The conversion
shipped in 85649cf used both, which the GitHub markdown view rejects
with:
Parse error on line 6: ...ding for<br/>already-issued leaves until
-----------------------^
Expecting 'SPACE', 'NL', 'DESCR', '-->', ... got 'INVALID'
(flowchart and sequenceDiagram tolerate <br/> + em-dashes inside
labels — only stateDiagram-v2 trips.)
Fix: shorten transition labels to single-line ASCII and move the
long-form descriptions into 'note right of <state>' blocks. Same
information, renders cleanly on GitHub.
active --> retiring : Retire(confirm=false)
retiring --> retired : Retire(confirm=true)
retired --> [*]
note right of retiring
Drain start. CA stops issuing
NEW children; existing children
keep issuing until they retire.
end note
note right of retired
Terminal. Refused if active children
remain (ErrCAStillHasActiveChildren
→ HTTP 409). OCSP keeps responding
for already-issued leaves until expiry.
end note
Verified locally:
Other mermaid blocks added in the audit pass (sequenceDiagram +
flowchart TD) keep their <br/> + em-dashes — those don't trip
GitHub's renderer. Only stateDiagram-v2 needed the fix.
No content lost. The note blocks carry every fact the old
multi-line transition labels had.
Doc-only commit.