The GitHub wiki of the repository is a generated, read-only mirror of docs/. docs/ is the single source of truth: edit pages in docs/, never in the wiki. Any manual wiki edit is overwritten by the next sync.

The wiki workflow (.github/workflows/wiki.yml) runs on every push to main that touches docs/**, mkdocs.yml, tools/wiki-sync/** or the workflow itself, and on manual dispatch. It runs wiki-sync build, clones <repo>.wiki.git, replaces its contents with the generated pages and pushes a commit docs: sync wiki from <sha> (only when something changed).

The tool lives in tools/wiki-sync/. It reads the nav from mkdocs.yml, writes flat pages, rewrites relative links between pages to wiki links, generates _Sidebar.md and _Footer.md, appends a mirror note to each page and deletes stale pages.

The wiki has no folders, so the path becomes the page name:

Directory prefixes: architecture to Architecture, adr to ADR, dev to Dev, ops to Ops, spikes to Spike, guides to Guide. The file stem is title-cased per hyphen segment and digits are kept. docs/plan/** (the German original) and adr/template.md are not mirrored; links to them point to the file on GitHub.

GitHub creates the wiki repository only when the first page is created in the web UI. Open https://github.com/lukislp/mowdeck/wiki, click "Create the first page" and save any content. Until then the workflow fails with the message "Wiki repository not initialised". After creating the page, re-run the workflow from the Actions tab; the generated pages replace the placeholder.

uv run poe wiki

This writes the pages to build/wiki (ignored by git). To pass a commit hash for the footer, call the tool directly: uv run wiki-sync build --docs docs --mkdocs mkdocs.yml --out build/wiki --commit <sha>.

Mirrored from docs/dev/wiki.md at commit 6a87264c6123f07c8474e153053525dc1816feb7. Edit the file in the repository, not this wiki page.