docs: reorganise into Guides / Operations / Governance

- 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.
This commit is contained in:
inference-admin committed 2026-11-17 00:04:24 +00:00
1 parent a6142d68f2
commit ac8cac02c6
13 files changed
+66 -29

No files matched your search

+6 -6
View File
@@ -10,13 +10,13 @@ funded through our [Open Collective](https://opencollective.com/inference-cooper
## Start here
- **New here?** → [Getting started](getting-started.md) — join, use the chat, and get involved in governance.
- **New here?** → [Getting started](guides/getting-started.md) — join, use the chat, and get involved in governance.
- **Why does this exist?** → [Background](background.md) — a one-page summary of the mission and history.
- **Which models can I use?** → [Models](models.md) — the full catalog of providers and models.
- **Want API access?** → [API access](api-access.md) — use our models programmatically.
- **Want community chat?** → [Getting started · Matrix](getting-started.md) — our federated Matrix server, including how to connect from any client and how to use an existing Matrix account.
- **Curious how it works?** → [Infrastructure](infrastructure.md) — a map of the stack and the codebase.
- **Wondering about the bot?** → [Working with the agent](working-with-the-agent.md) — what the co-op's agents do, who can instruct them, and what always needs a human.
- **Which models can I use?** → [Models](guides/models.md) — the full catalog of providers and models.
- **Want API access?** → [API access](guides/api-access.md) — use our models programmatically.
- **Want community chat?** → [Getting started · Matrix](guides/getting-started.md) — our federated Matrix server, including how to connect from any client and how to use an existing Matrix account.
- **Curious how it works?** → [Infrastructure](operations/infrastructure.md) — a map of the stack and the codebase.
- **Wondering about the bot?** → [Working with the agent](operations/agentic-systems.md) — what the co-op's agents do, who can instruct them, and what always needs a human.
- **Need help or have an idea?** → [Support & feature requests](https://git.inference.coop/co-op/support) — open an issue.
## Key links
+1 -1
View File
@@ -9,7 +9,7 @@ together.
We are a small cooperative by design, fiscally sponsored by the nonprofit
[Metagov](https://metagov.org) and managing member dues on
[Open Collective](https://opencollective.com/inference-cooperative).
For how to join and use it, see [Getting started](getting-started.md);
For how to join and use it, see [Getting started](guides/getting-started.md);
for our governance model, see the [Charter](governance/charter.md).
## How we got here
+14
View File
@@ -0,0 +1,14 @@
# Governance
How the co-op decides things, and the agreements members share.
## In this section
- [Charter](charter.md) — the co-op's founding agreement
- [Code of conduct](code-of-conduct.md) — what we expect from each other
- [Terms of Service](terms-of-service.md) — the agreement covering use of the service
- [Privacy Policy](privacy-policy.md) — what we collect and why
- [How to make a proposal](make-a-proposal.md) — the path from an idea to a decision
- [Open questions](open-questions.md) — matters the co-op has not settled yet
Operational roles sit in [Operations](../operations/).
+1 -1
View File
@@ -34,7 +34,7 @@ Two things worth being precise about:
[model list](models.md) distinguishes policy-based zero retention from
enclave-based protection.
Full detail, including what we can and cannot see: [privacy policy](governance/privacy-policy.md).
Full detail, including what we can and cannot see: [privacy policy](../governance/privacy-policy.md).
## Get a key
View File
File renamed without changes.
@@ -72,7 +72,7 @@ with the account you created in step 1.
nothing lands in your history or our database. To make this your default,
open **Settings → Conversations** and turn on **Default Temporary Chat**.
For anything sensitive, we recommend a temporary chat — ideally paired with
a 🔒 enclave model. See [Privacy](governance/privacy-policy.md#4-what-we-can-see-an-honest-caveat)).
a 🔒 enclave model. See [Privacy](../governance/privacy-policy.md#4-what-we-can-see-an-honest-caveat)).
Your usage draws from your monthly allowance; you can see it on the
[Member Dashboard](https://dashboard.inference.coop).
@@ -156,17 +156,17 @@ privacy, and direction happen on our **Loomio forum**:
the co-op grows.
- The updates feed is posted by the co-op's automation account. See
[Working with the agent](working-with-the-agent.md) for the agents behind
[Working with the agent](../operations/agentic-systems.md) for the agents behind
it, what they do, and how members interact with them.
- See the [Charter](governance/charter.md) for how governance is structured.
- See [Open questions](governance/open-questions.md) for the decisions currently on the table.
- See the [Charter](../governance/charter.md) for how governance is structured.
- See [Open questions](../governance/open-questions.md) for the decisions currently on the table.
### Help build it
Everything we run is open source, and members are welcome to contribute code,
documentation, and design. See [Infrastructure](infrastructure.md) for the map
documentation, and design. See [Infrastructure](../operations/infrastructure.md) for the map
and the "Contributing" section for how to propose changes through
[git.inference.coop](https://git.inference.coop).
File renamed without changes.
+12
View File
@@ -0,0 +1,12 @@
# Guides
How to join, use the chat, choose a model, call the API, and understand what that
usage costs in energy and emissions.
## In this section
- [Getting started](getting-started.md) — join, use the chat, and get involved in governance.
- [Guest access](guest-access.md) — inviting someone without a full membership.
- [Models](models.md) — the catalogue of providers and models.
- [API access](api-access.md) — use the models programmatically.
- [Energy & carbon](energy.md) — the energy and emissions behind the service.
+1 -1
View File
@@ -313,4 +313,4 @@ we commit not to. Requests made through the **API** with your own key are a
different matter: those are **not stored on our side at all**, beyond the usage
record needed for metering ([API access](api-access.md)). The full distinction —
what's architecturally private versus what's a policy commitment — is in the
[Privacy Policy](governance/privacy-policy.md).
[Privacy Policy](../governance/privacy-policy.md).
+21 -12
View File
@@ -68,14 +68,19 @@ theme:
nav:
- Home: README.md
- Getting started: getting-started.md
- Guest access: guest-access.md
- Models: models.md
- API access: api-access.md
- Energy & carbon: energy.md
- Infrastructure: infrastructure.md
- Background: background.md
- Working with the agent: working-with-the-agent.md
- Guides:
- Overview: guides/index.md
- Getting started: guides/getting-started.md
- Guest access: guides/guest-access.md
- Models: guides/models.md
- API access: guides/api-access.md
- Energy & carbon: guides/energy.md
- Operations:
- Overview: operations/index.md
- Agentic systems: operations/agentic-systems.md
- Infrastructure: operations/infrastructure.md
- Roles: operations/roles.md
- Steward Policy: operations/steward-policy.md
- Governance:
- Overview: governance/index.md
- Charter: governance/charter.md
@@ -84,10 +89,7 @@ nav:
- Terms of Service: governance/terms-of-service.md
- Privacy Policy: governance/privacy-policy.md
- How to make a proposal: governance/make-a-proposal.md
- Operations:
- Overview: operations/index.md
- Roles: operations/roles.md
- Steward Policy: operations/steward-policy.md
- Background: background.md
plugins:
# Built-in, offline search — the index is a JSON file in the build output.
@@ -100,6 +102,13 @@ plugins:
"open-questions.md": "governance/open-questions.md"
"terms-of-service.md": "governance/terms-of-service.md"
"privacy-policy.md": "governance/privacy-policy.md"
"getting-started.md": "guides/getting-started.md"
"guest-access.md": "guides/guest-access.md"
"models.md": "guides/models.md"
"api-access.md": "guides/api-access.md"
"energy.md": "guides/energy.md"
"infrastructure.md": "operations/infrastructure.md"
"working-with-the-agent.md": "operations/agentic-systems.md"
hooks:
# Rewrites directory-style links (e.g. [incidents/](incidents/)) to the
File renamed without changes.
+4 -2
View File
@@ -1,7 +1,7 @@
# Operations
How the co-op runs its own work: who holds which role, what they are responsible for,
and the agreements that come with it.
How the co-op runs its own work: who holds which role, the agreements that come
with it, the stack it runs on, and the agents that work in it.
## In this section
@@ -11,3 +11,5 @@ and the agreements that come with it.
and rotated, their duties and privileged access, stipends, accountability and handover.
More operational documents will land here as roles and procedures are agreed.
- [Agentic systems](agentic-systems.md) — what the co-op's agents do, who can instruct them, and what always needs a human.
- [Infrastructure](infrastructure.md) — a map of the stack and the codebase.
@@ -169,7 +169,7 @@ and ask for review.
## Models and providers
The co-op serves models from multiple providers — Tinfoil for architectural
privacy, GreenPT and Regolo for renewable energy. See the [model list](models.md),
privacy, GreenPT and Regolo for renewable energy. See the [model list](../guides/models.md),
the single source of truth for which models are available and how they're named.
## Security posture (plain language)