[nbudin]

Purpose

The deployer docs (deploy/README.md and the staged rollout runbook) read better as part of the doc site than as markdown files in the repo root, and the doc site is where people look for how to run Intercode. This moves them to doc-site/docs/deploying under a new "Deploying Intercode" sidebar category. The docker-compose example and example.env move to doc-site/static/deploying so the pages can link to them as downloads.

The references in the README, the nginx front proxy files, the assets Dockerfile and the cloudfront_intercode README now point at the published pages.

Changes

💻 Engineer-facing

• deploy/ is gone; its files are renames, so history follows them.
• Links inside the moved pages that used to be relative paths into the repo (the Terraform modules, the logging module) are now absolute GitHub URLs, since the doc site can't resolve them.
• I rebased onto main and resolved one conflict in staged-rollout.md: Let assets_bucket_intercode trust every CloudFront distribution in the account #12325 reworded the bucket policy bullet in the old deploy/staged-rollout.md, and this branch had rewritten the same bullet's link. The result keeps the new wording (set allow_account_cloudfront_distributions or list the distribution) with the absolute link.

Testing

yarn build in doc-site succeeds and compiles the new pages. It does print a broken-anchor warning for /docs/concepts/events-and-runs linking to signups#registration-policies; that page isn't touched here. I haven't looked at the rendered pages in a browser or checked the published URLs, which won't exist until this deploys.

Release plan and notes

The in-repo references point at https://intercode.interactiveliterature.org/docs/deploying, so they'll be dead links until the doc site deploys this. Part of #12260.

🚢

🤖 Generated with Claude Code

[github-actions]

Code Coverage Report: Only Changed Files listed

Package	Base Coverage	New Coverage	Difference
app/graphql/concerns/cms_parent_implementation.rb	🔴 45.95%	🔴 43.24%	🔴 -2.71%
app/javascript/setupI18Next.ts	🟢 82.76%	🟢 89.66%	🟢 6.9%
Overall Coverage	🟢 67.35%	🟢 67.35%	⚪ 0%

Minimum allowed coverage is 0%, this run produced 67.35%