alphaswarm-docs-archive
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/ — same module as the live docs, distinct Pages project |
| Spec | reuses the docs-edge stack pattern at alphaswarm_platform/configs/terraform/stacks/docs-edge.yaml (separate 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.