alphaswarm-docs-archive
Catalog date: 2026-06-24.
Status. Currently
archive.alpha-swarm.aiis provisioned incloudflare_pages_docs/main.tfas an additional custom domain on the same Cloudflare Pages project that serves the live docs — there is no separate per-epoch build pipeline,/v<n>/directory structure, orarchive-frozenGitHub Action in eitheralphaswarm_docsoralphaswarm_platformyet. The epoch-freeze design below is the intended target, not the current implementation.
Sunset documentation archive. Stripe-style: every public-API epoch
freezes a snapshot of alphaswarm-docs and surfaces it under
archive.alpha-swarm.ai/<epoch>/ so customers running pinned API
versions still have a working manual.
Identity
| Field | Value |
|---|---|
| Service id | alphaswarm-docs-archive |
| Role | docs-archive |
| Hosted on | Cloudflare Pages |
| Public URL | https://archive.alpha-swarm.ai |
Layout
/v1/...— first public epoch (frozen)/v2/...— current epoch (mirrorsdocs.alpha-swarm.ai)/v<n>/...— every previous epoch retained for the deprecation window declared in the release notes.
Each epoch directory is a frozen build of alphaswarm_docs/ at the
tag matching the epoch.
Deployment surface
| Surface | Where |
|---|---|
| Terraform module | alphaswarm_platform/terraform/modules/cloudflare_pages_docs/ — the same module and the same Cloudflare Pages project as the live docs, just an additional custom domain (archive_hostname) |
| Spec | the same docs-edge stack at alphaswarm_platform/configs/terraform/stacks/docs-edge.yaml — not a separate stack or workspace |
Operations
- Immutability: archive content is read-only after the epoch
freezes. PRs targeting an archive branch are auto-rejected by the
archive-frozenGitHub Action. - Sunset window: epochs hold for the deprecation window declared in the matching release note (typically 12 months).
- Discoverability: the live docs link to
archive.alpha-swarm.aiwhenever an API breaks compatibility.
See also
alphaswarm-docs.md— live docs.- Stripe API versioning — the model this archive imitates.