- Guides/: getting started, guest access, models, API access, energy & carbon
- Operations/: agentic systems (was 'working with the agent'), infrastructure, roles, steward policy
- Governance/: unchanged, now with its overview page
Lateral links and the homepage updated; redirects keep the old root URLs alive.
Records the membership poll that formally approved Nathan Schneider as general
manager (closed 2026-10-30, 74 members voting), what the role does, and how roles
are added or changed. Linked from the Operations index and the nav.
The Steward Policy passed in Loomio, so it lands as operations/steward-policy.md
(verbatim from the shared draft, one garbled phrase repaired: 'finances alloas
determined by' -> 'finances allow, as determined by').
Governance and Operations now have index pages, and both are in the nav as
section overviews, so each section has a landing page instead of a bare menu.
Make clear this is the documentation, not the co-op homepage:
- site_name -> 'Inference Cooperative docs' (drives the <title> and the
header brand on every page)
- homepage h1 -> 'Inference Cooperative docs'
- footer gains a 'Co-op homepage' link to https://inference.coop/, added
in the existing copyright.html override alongside the Gitea source link
- mkdocs.yml: list 'Working with the agent' in the nav (a page not in the
nav is hard to find).
- working-with-the-agent.md: the operator token runbook moved out of the
published site into the git-only co-op/ops-docs, so the relative link
(operator-token-runbook.md) would 404; point it at the runbook's new home
in ops-docs, as infrastructure.md already does. Wording unchanged.
- README: render the Key links as real Markdown links (mailto: for the
contact address); drop the 'lives in a public git repository' note now
that the footer carries the source link.
- mkdocs.yml: add a theme override (custom_dir: overrides) that puts a
'Documentation source' link in the footer of every page.
- Move the operator runbook, maintenance notes and incident write-up out
of the published site into the git-only co-op/ops-docs repository;
remove them from the nav and repoint cross-references at Gitea.
Dark mode: the slate scheme set the header to #3f6b3e, a dark green on a dark page, so
the bar disappeared into the background. It is now green-mid with near-black text.
Typography moves to publishing/typography.css, loaded after brand.css, and declares
Figtree on the elements themselves -- Material defines --md-text-font-family on <body>,
so a :root value loses to it by DOM proximity. Heading colours are scoped to the light
scheme, since ink is unreadable on the dark one.
The theme was configured with primary: teal and accent: deep orange, so every page
shipped data-md-color-primary="teal" / data-md-color-accent="deep-orange" and Material
set --md-primary-fg-color and friends on <body>. Those variables then beat brand.css,
which sets them on <html>, because a value on the nearer ancestor wins for descendants
regardless of specificity. The result: cream background and ink from brand.css applied,
but the header, links and accents stayed Material's defaults.
primary/accent are now "custom", Material emits no palette of its own, and the co-op
variables in publishing/brand.css take effect.
A MkDocs hook turns links like [incidents/](incidents/) — which Gitea
renders as a directory listing but a static site would resolve against the
page URL — into links to the generated landing page for that directory.
Renders the repository's Markdown (which stays where it is) into a
member-readable static site with Material for MkDocs: co-op brand colours
and logo, self-hosted OFL Figtree, offline search, no external hosts.
- publishing/build.sh stage .site-src, render .site-build (mkdocs --strict)
- publishing/deploy.sh write the build into the Surfer app container
- publishing/webhook-receiver.py + .service Gitea push hook on main
triggers pull -> build -> deploy (agent host, no new
Cloudron app)