Skip to content

Add 'Updating Blueprints' docs page#18

Merged
deanleigh merged 2 commits into
mainfrom
docs/updating-blueprints
Apr 17, 2026
Merged

Add 'Updating Blueprints' docs page#18
deanleigh merged 2 commits into
mainfrom
docs/updating-blueprints

Conversation

@deanleigh
Copy link
Copy Markdown
Collaborator

Summary

  • New user-facing docs page explaining what happens to workflow mappings when the underlying blueprint changes (safe changes, gotchas, the duplicate-block-types edge case, recommended workflow)
  • Planning note for future Playwright-driven screenshot automation — docs are text-heavy and would benefit from auto-regenerated screenshots
  • CLAUDE.md updated to adopt the issue-first workflow used in sibling projects

Closes #17

Test plan

  • Docs site builds locally (verified: dev server running at localhost:4322)
  • New page renders at /UpDoc/updating-blueprints/
  • Sidebar entry appears under "Creating Documents from Source"
  • GitHub Actions deploys docs to GitHub Pages on merge

🤖 Generated with Claude Code

deanleigh and others added 2 commits April 17, 2026 16:00
Document the consequences of updating or remaking blueprints so workflow
authors understand when mappings survive and when they need attention.
Add a planning note for future Playwright-driven screenshot automation
to keep the docs visually accurate without manual re-capture.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adopt the same issue-first workflow used in sibling projects: check for
an existing issue before starting non-trivial work, create one if it's
missing, reference it in commits and PRs so the board stays in sync.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@deanleigh deanleigh merged commit 426f2d0 into main Apr 17, 2026
@deanleigh deanleigh deleted the docs/updating-blueprints branch April 17, 2026 15:07
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