Public docs, news and releases for archie on offloaded.dev #1020

Closed
opened 2026-10-27 13:38:42 +00:00 by sam · 1 comment
Owner

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'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
sam self-assigned this 2026-10-27 13:38:42 +00:00
sam closed this issue 2026-10-27 13:38:42 +00:00
Author
Owner

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.

_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.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#1020