archie-core already builds a static MkDocs site: task docs:site = mkdocs build --strict -> ./site (gitignored). site_url is https://docs.offloaded.dev/.
The ansible repo already has the shipping role (vectislabs.automation docs_site): rsync /work/apps/archie-core/site -> galaxy:/opt/archie-docs/site, nginx:1.29-alpine on Traefik's proxy network as container archie-docs:80, no host port.
The ansible offloaded role is the libp2p bootstrap/relay node (discovery.offloaded.dev, UDP 4001) and is unrelated to the web surface.
Two lanes: (a) infra deploy + Traefik/TLS/routing on galaxy; (b) the pi.dev-style news + generated release pages in archie-core.
Notes
CORRECTION (Sam, directly): pi.dev is a reference for the IDEA ONLY -- a news page plus per-version release notes. It is NOT a design to clone. No copying pi.dev's visual design, copy/voice, URL scheme, section names or page structure. Build archie's own, on the existing MkDocs Material theme and archie's two-component release model. (The epic description's 'reference to imitate' wording is superseded by this note.)
Close reason
done
Imported from beads archie-core-2ncm · GitHub #1043 · type epic · priority P1 · created 2026-09-21 · closed 2026-09-28
Sam's requirement: archie's public-facing documentation, news and releases are served from offloaded.dev (Cloudflare -> galaxy). Reference to imitate: https://pi.dev/news and https://pi.dev/news/releases/0.87.0.
Current truth (verified 2026-09-22):
- archie-core already builds a static MkDocs site: `task docs:site` = mkdocs build --strict -> ./site (gitignored). site_url is https://docs.offloaded.dev/.
- The ansible repo already has the shipping role (vectislabs.automation docs_site): rsync /work/apps/archie-core/site -> galaxy:/opt/archie-docs/site, nginx:1.29-alpine on Traefik's proxy network as container archie-docs:80, no host port.
- The ansible `offloaded` role is the libp2p bootstrap/relay node (discovery.offloaded.dev, UDP 4001) and is unrelated to the web surface.
- Live: https://offloaded.dev -> 525 (Cloudflare origin SSL handshake failed); https://docs.offloaded.dev -> 000. Nothing is serving.
Two lanes: (a) infra deploy + Traefik/TLS/routing on galaxy; (b) the pi.dev-style news + generated release pages in archie-core.
### Notes
CORRECTION (Sam, directly): pi.dev is a reference for the IDEA ONLY -- a news page plus per-version release notes. It is NOT a design to clone. No copying pi.dev's visual design, copy/voice, URL scheme, section names or page structure. Build archie's own, on the existing MkDocs Material theme and archie's two-component release model. (The epic description's 'reference to imitate' wording is superseded by this note.)
### Close reason
done
---
_Imported from beads `archie-core-2ncm` · GitHub #1043 · type epic · priority P1 · created 2026-09-21 · closed 2026-09-28_
sam
added the highepic labels 2026-10-27 13:38:42 +00:00
DECISION 2026-09-22 (Sam): docs.offloaded.dev is dead and MkDocs is retired as a public surface. offloaded.dev serves the Astro app only. News/releases already render in the app from the canonical docs/news/releases.json; the remaining published docs (21 pages: index, architecture/, guides/, and the 3 published PRDs) are being ported into the app via a new canonical artifact (tools/docsite -> docs/data/generated/docs.json) that the app vendors, same pattern as releases. The MkDocs router is off; the archie-docs container and /opt/archie-docs/site are retained but unrouted. Children of this epic that assume a docs subdomain or a MkDocs deploy are superseded.
_sam wrote (originally 2026-09-22):_
DECISION 2026-09-22 (Sam): docs.offloaded.dev is dead and MkDocs is retired as a public surface. offloaded.dev serves the Astro app only. News/releases already render in the app from the canonical docs/news/releases.json; the remaining published docs (21 pages: index, architecture/**, guides/**, and the 3 published PRDs) are being ported into the app via a new canonical artifact (tools/docsite -> docs/data/generated/docs.json) that the app vendors, same pattern as releases. The MkDocs router is off; the archie-docs container and /opt/archie-docs/site are retained but unrouted. Children of this epic that assume a docs subdomain or a MkDocs deploy are superseded.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Sam's requirement: archie's public-facing documentation, news and releases are served from offloaded.dev (Cloudflare -> galaxy). Reference to imitate: https://pi.dev/news and https://pi.dev/news/releases/0.87.0.
Current truth (verified 2026-09-22):
task docs:site= mkdocs build --strict -> ./site (gitignored). site_url is https://docs.offloaded.dev/.offloadedrole is the libp2p bootstrap/relay node (discovery.offloaded.dev, UDP 4001) and is unrelated to the web surface.Two lanes: (a) infra deploy + Traefik/TLS/routing on galaxy; (b) the pi.dev-style news + generated release pages in archie-core.
Notes
CORRECTION (Sam, directly): pi.dev is a reference for the IDEA ONLY -- a news page plus per-version release notes. It is NOT a design to clone. No copying pi.dev's visual design, copy/voice, URL scheme, section names or page structure. Build archie's own, on the existing MkDocs Material theme and archie's two-component release model. (The epic description's 'reference to imitate' wording is superseded by this note.)
Close reason
done
Imported from beads
archie-core-2ncm· GitHub #1043 · type epic · priority P1 · created 2026-09-21 · closed 2026-09-28sam wrote (originally 2026-09-22):
DECISION 2026-09-22 (Sam): docs.offloaded.dev is dead and MkDocs is retired as a public surface. offloaded.dev serves the Astro app only. News/releases already render in the app from the canonical docs/news/releases.json; the remaining published docs (21 pages: index, architecture/, guides/, and the 3 published PRDs) are being ported into the app via a new canonical artifact (tools/docsite -> docs/data/generated/docs.json) that the app vendors, same pattern as releases. The MkDocs router is off; the archie-docs container and /opt/archie-docs/site are retained but unrouted. Children of this epic that assume a docs subdomain or a MkDocs deploy are superseded.