Skip to content

docs(architecture): document the two-repo content pipeline#203

Merged
wab merged 1 commit into
mainfrom
doc/two-repo-content-pipeline
May 22, 2026
Merged

docs(architecture): document the two-repo content pipeline#203
wab merged 1 commit into
mainfrom
doc/two-repo-content-pipeline

Conversation

@wab

@wab wab commented May 22, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add docs/architecture/two-repo-content-pipeline.md — canonical architecture note explaining the posts / website split, with four Mermaid diagrams (system, content-flow sequence, asset-flow sequence, content-type ER)
  • Update README.md — pointer in the Documentation section
  • Update docs/architecture/overview.md — intro link to the new page

Acceptance checklist

  • New contributor reading two-repo-content-pipeline.md alone can answer: where does content live, where do assets live + how do they reach the website, build-time vs. runtime responsibilities, which repo to PR against
  • All four Mermaid diagrams render without errors in GitHub preview
  • No contradiction with docs/architecture/*.md or posts/CONTEXT.md

Out of scope

  • Rewriting overview.md / patterns.md / source-tree.md end-to-end
  • Migration history
  • Vercel deployment setup

Closes #200.

Add docs/architecture/two-repo-content-pipeline.md with system diagram,
content-flow sequence, asset-flow sequence, and ER-ish content-type
relationships. Covers repo boundaries and env var reference.

Update README.md (pointer in Documentation section) and
docs/architecture/overview.md (intro link). Closes #200.
@vercel

vercel Bot commented May 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
website Ready Ready Preview May 22, 2026 9:27am

Request Review

@wab wab merged commit af00254 into main May 22, 2026
5 checks passed
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.

docs(architecture): document the two-repo content pipeline (posts + website) with diagrams

1 participant