dorfteich/docs/manual
Claude Fable 5 ffcc337ed0
Some checks failed
CD / Build and push images (push) Successful in 3m57s
CD / Deploy to Test (push) Successful in 9s
CI / Lint, typecheck, test (push) Failing after 4m16s
CI / Auth e2e pack (push) Has been skipped
CI / Import/export fidelity gate (push) Has been skipped
CI / Build container images (push) Has been skipped
CD / Smoke tests against Test (push) Successful in 1m19s
CD / Promote to Int (push) Successful in 11s
Page-tree parity for the public REST API and MCP (#110)
The slug-based machine surfaces now see and shape the hierarchy:

- REST: page list/detail carry parent (the parent page's slug, nulled
  when the token's user may not read it — same no-leak rule as the
  internal list); create accepts parent; PATCH accepts parent
  (slug nests, null moves to the top level, appended at the end of the
  new sibling group via the new PagesService.moveToEnd). Cycle/depth
  refusals keep their regular error codes. OpenAPI updated.
- MCP: list_pages returns parent, create_page takes an optional parent
  slug, update_page moves with parent (slug|null); tool errors carry
  the api code (page_cycle covered in the e2e pack).
- ZIP export deliberately stays flat — noted in features.md; the
  hierarchy is organizational only.

e2e: REST pack covers nested create, list shape, move/root-move, 409
page_cycle, 404 unknown parent; MCP pack covers nested create, list
parent, and the cycle tool error.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 10:49:52 +02:00
..
api-guide.md Page-tree parity for the public REST API and MCP (#110) 2026-07-14 10:49:52 +02:00
mcp-guide.md Page-tree parity for the public REST API and MCP (#110) 2026-07-14 10:49:52 +02:00
pond-admin-guide.md German translations of the seven user-facing docs under docs/de/ 2026-07-12 19:28:50 +02:00
README.md German translations of the seven user-facing docs under docs/de/ 2026-07-12 19:28:50 +02:00
site-admin-guide.md German translations of the seven user-facing docs under docs/de/ 2026-07-12 19:28:50 +02:00
user-guide.md German translations of the seven user-facing docs under docs/de/ 2026-07-12 19:28:50 +02:00

Dorfteich manuals

User-facing documentation, by audience. German translations live in docs/de/; English is authoritative when the two diverge.

Guide For
Feature overview anyone wondering what Dorfteich is
User guide everyday members
Pond-admin guide people administering a pond
Site-admin guide instance administrators
API guide scripts and integrations
MCP guide connecting AI assistants
Developer guide plugin authors and core contributors

Operating an instance (install, update, backup, monitoring): self-hosting. Internals: architecture.