Skip to content

docs: adaptive themed diagrams maintainer guide - #2

Draft
cursor[bot] wants to merge 3 commits into
mainfrom
cursor/documentation-automation-system-01ed
Draft

docs: adaptive themed diagrams maintainer guide#2
cursor[bot] wants to merge 3 commits into
mainfrom
cursor/documentation-automation-system-01ed

Conversation

@cursor

@cursor cursor Bot commented Sep 8, 2026

Copy link
Copy Markdown

Summary

Documentation companion to PR #1 (adaptive themed website diagrams).

Docs added/updated

  • website/public/docs/adaptive-themed-diagrams.adoc — maintainer runbook for the Mermaid → Themed SVG pipeline
  • website/README.adoc — replaced incorrect Food Truck Nerdz content with CentrMark website guidance
  • README.adoc — Docs | Dev-Centr badge and Website section pointers
  • spec/informal.adoc@image inline directive with themed property
  • packages/cmk-renderer/README.md@image[themed=true] rendering note
  • website/public/docs/changelog.adoc — synced with root changelog
  • website/src/routes/docs/* — wired new doc into site navigation

Codepaths covered

  • website/scripts/generate-diagrams.mjs
  • website/diagrams/* (.mmd, .theme.json)
  • website/public/images/* (.svg, .host.svg, .fixed.svg)
  • website/src/entry-client.tsx + app.css (runtime upgrade + host tokens)
  • packages/cmk-renderer/src/html.ts (@image, data-themed-svg)
  • examples/images.cmk

Key knowledge gaps addressed

  • How to regenerate and verify themed diagram assets in CI
  • How @image[themed=true] connects CMK content to the Themed SVG runtime
  • Where to add new diagrams and host-token CSS overrides
  • Troubleshooting stale assets, puppeteer/Mermaid CLI, and contrast validation
Open in Web View Automation 

AMDphreak and others added 3 commits September 8, 2026 06:39
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
- Add website/public/docs/adaptive-themed-diagrams.adoc with pipeline,
  generation commands, safety checks, and troubleshooting
- Wire the page into /docs routes and replace incorrect website README
- Add Docs | Dev-Centr badge to root README.adoc
- Document @image[themed=true] in spec/informal.adoc and cmk-renderer README
- Sync website/public/docs/changelog.adoc with root changelog source

Co-authored-by: Ryan Johnson <AMDphreak@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants