Skip to content

Serve the state diagram from the docs site and drop the contributors image - #511

Merged
em3s merged 2 commits into
mainfrom
docs/snapshot-remote-images
Oct 14, 2026
Merged

em3s merged 2 commits into
mainfrom
docs/snapshot-remote-images

Conversation

@em3s

@em3s em3s commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The repo is moving to minimal maintenance and will be archived, but the docs site stays up without rebuilds. Two images on it are still fetched from third-party services on every page load: the full state diagram in design/mutation from plantuml.com, and the contributors image in community from contrib.rocks. If either service changes, the image breaks and nobody will be around to fix it.

The state diagram is now a committed SVG snapshot. The Contributors section is removed, since the GitHub contributors page already covers it.

Changes

  • Add public/images/design/mutation-state-transitions.svg and point design/mutation.mdx at it
  • Add scripts/snapshot-remote-images.mjs to re-fetch the diagram. It reads the PlantUML source from the existing "Edit on PlantUML" link, so that link stays the source of truth
  • Remove the Contributors section from community.mdx

Going back is easy. Run the script to refresh the snapshot, or point the Markdown image back at the plantuml.com URL built in the script.

How to Test

cd website
node scripts/snapshot-remote-images.mjs   # reproduces the committed SVG byte for byte
git diff --exit-code public/images
npm run build
grep -rl 'plantuml.com/plantuml/png\|contrib.rocks' dist --include=*.html   # no output

AI Assistance

  • This PR was written largely with AI assistance.
    • Tool / model: Claude Code (Claude Opus 5.5)

em3s and others added 2 commits October 14, 2026 11:19
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@em3s em3s changed the title Serve the state diagram and contributors image from the docs site Serve the state diagram from the docs site and drop the contributors image Oct 14, 2026
@em3s
em3s merged commit f54bcf2 into main Oct 14, 2026
3 checks passed
@em3s
em3s deleted the docs/snapshot-remote-images branch October 14, 2026 02:23
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.

1 participant