Skip to content

Correct system diagrams - #25

Merged
Jason-Doyle merged 1 commit into
mainfrom
docs/diagram-accuracy
Sep 26, 2026
Merged

Jason-Doyle merged 1 commit into
mainfrom
docs/diagram-accuracy

Conversation

@Jason-Doyle

Copy link
Copy Markdown
Owner

Summary

  • correct README read flow so HEAD retrieval, immutable-object retrieval, and the 16 MiB decoded-object boundary are separate stages
  • limit the README mutation flow to document create, replace, delete, and restore operations; document administrative maintenance separately
  • correct the trust diagram so the deployment master key remains inside the platform boundary and only derived authorised scope keys reach the browser
  • model read-bundle fallback after the bundle request rather than as a pre-request decision
  • show cached HEAD handling, decoded-object limits, bounded write retries, and explicit retry exhaustion
  • regenerate the four affected content-addressed SVGs; the other twelve diagrams remain unchanged

Validation

  • rendered all four README Mermaid blocks with Mermaid CLI 12
  • npm run site:diagrams
  • npm run verify:docs
  • npm run site:check
  • npm run site:build
  • npm run site:test
  • npm run site:deploy:check

@Jason-Doyle
Jason-Doyle merged commit 623a253 into main Sep 26, 2026
1 check passed
@Jason-Doyle
Jason-Doyle deleted the docs/diagram-accuracy branch September 26, 2026 05:00
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