Skip to content

Centralize arch-docs deployment to eliminate Cloudflare Workers#19

Merged
greynewell merged 1 commit intomainfrom
centralized-arch-docs
Mar 9, 2026
Merged

Centralize arch-docs deployment to eliminate Cloudflare Workers#19
greynewell merged 1 commit intomainfrom
centralized-arch-docs

Conversation

@greynewell
Copy link
Contributor

What this does

Moves all arch-docs to deploy directly into site/{name}/ in this repo instead of individual GitHub Pages per repo. The full site — index, repo landing pages, and all deep arch-docs pages — serves from repos.supermodeltools.com with no Workers needed.

How it works

Each repo's arch-docs.yml now:

  1. Runs supermodeltools/arch-docs@main with base-url: https://repos.supermodeltools.com
  2. Clones this central repo and copies output to site/{name}/
  3. Commits and pushes (with retry/rebase for concurrency)

build-index.yml triggers on site/** changes, so any arch-docs push redeploys the full site.

generate-index.go skips generating landing pages for repos where arch-docs already exist in site/{name}/.

After merging

  1. Create a PAT with contents:write on this repo, add as BOT_TOKEN org secret (or per-repo secret)
  2. Run ./update-arch-docs-workflows.sh to push the new workflow to all 14 existing repos
  3. Trigger each repo's arch-docs.yml workflow for initial deploys
  4. Update Cloudflare DNS: point repos.supermodeltools.com CNAME → graphtechnologydevelopers.github.io
  5. Remove Worker routes

🤖 Generated with Claude Code

Each repo's arch-docs workflow now pushes output directly to
site/{name}/ in this central repo (with base-url set to
repos.supermodeltools.com) instead of deploying to individual
GitHub Pages. This means the full site — index, landing pages, and
all deep arch-docs pages — lives at repos.supermodeltools.com with
no Workers needed.

Changes:
- generate-index.go: fix sitemap to use urlset (not sitemapindex),
  skip generating landing pages for repos that already have arch-docs
- build-index.yml: also trigger on site/** changes so a new arch-docs
  push redeploys the full site
- setup-community-repos.sh: update workflow template with new approach
- update-arch-docs-workflows.sh: new script to push updated workflow to
  all existing repos and set BOT_TOKEN secret

To complete setup:
1. Create a PAT with contents:write on graphtechnologydevelopers.github.io
2. Run: BOT_TOKEN=ghp_... ./update-arch-docs-workflows.sh
3. Trigger each repo's arch-docs workflow to do initial deploys

Co-Authored-By: Claude <noreply@anthropic.com>
@greynewell greynewell merged commit 38c3442 into main Mar 9, 2026
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