dorfteich/docs/manual
Claude Fable 5 6c98a71d34
Some checks failed
CD / Build and push images (push) Successful in 3m57s
CD / Deploy to Test (push) Successful in 11s
CI / Lint, typecheck, test (push) Successful in 4m32s
CI / Build container images (push) Has been skipped
CD / Smoke tests against Test (push) Successful in 1m14s
CD / Promote to Int (push) Successful in 11s
CI / Auth e2e pack (push) Failing after 2m51s
CI / Import/export fidelity gate (push) Has been skipped
Favorites: personal page stars, golden icons, sidebar filter (#132)
Semantics changed from the issue during planning (documented there,
comment 1192): favorites are PERSONAL per user, not pond-wide — the
sys-fav label approach is dropped entirely. Storage is a page_favorites
table (userId+pageId, FK cascade); PUT/DELETE /pages/:id/favorite
toggles idempotently and needs read access only (#60 404 semantics —
a star is a note-to-self, not a page modification), GET
/ponds/:id/favorites lists the account's stars sliced to still-readable
pages. Trashed pages keep their rows, so restore keeps the star; purge
cascades it away.

Web: one shared ['favorites', pondId] query feeds the TopBar star
(between labels and history, golden when set), the golden tree icons in
the sidebar, and a latching "Favorites" filter button next to the view
switch that narrows either view (combinable with the label filter).
No public-API/MCP exposure — with the label approach gone, that parity
is no longer free; favorites stay UI-only for now.

New favorites e2e pack (star toggle, golden icon, filter, per-user
isolation) wired into CI; DB suite covers the round-trip, read gating,
and the trash/restore/purge lifecycle.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fb2VzvcoBPHkjh8bZ6PzQn
2026-07-16 12:03:55 +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 QA: wire the M13 packs into CI, document the vault import (#119) 2026-07-14 18:28:45 +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 Favorites: personal page stars, golden icons, sidebar filter (#132) 2026-07-16 12:03:55 +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.