Repository navigation
doction 0.31.11
Documentation, CI and repository hygiene, plus the fixes for issues #42, #44 and #45. No API
or MCP contract changed.
Added
- Public documentation site at https://doction.site.
docs/index.mdis a landing page
(what doction is, how it works, the REST and MCP entry points, self-hosting, a map of every
page), served at the root by a small MkDocs hook with the README at/introduction/. The
site uses the application's own visual language — its tokens, the vendored Manrope,
Instrument Serif and JetBrains Mono, the terminal mark — and loads nothing from a
third-party host: no Google Fonts, no GitHub API call, no remote badge images.
pages.yamlredeploys it on every push tomainthat touches the documentation.
Changed
- CI on
maintakes about 4 minutes instead of 10. Thetest,webandpublishjobs
shared one build-cache scope and overwrote each other, so only 3 of 59 steps were ever
cached; each now has its own, andpublishreuses thewebjob's layers (6:48 → 0:49).
The SPA stage is built once on the build host instead of again under QEMU for arm64. The
runtime'sapt-get upgradelayer is refreshed weekly (APT_REFRESH, the ISO week) so a
working cache does not freeze Debian's security fixes. openspec/andAGENTS.mdare no longer versioned: both are maintainer-local, gitignored
likeCLAUDE.md, and no tracked document points at them.make specskips when
openspec/is absent.- Pending work is tracked in GitHub issues (#60–#65) rather than a roadmap file.
- The README is a short tour — screenshots, a quick start, the licence. Documentation that
said the same thing in two places now says it once and links: features and the page map
ondocs/index.md, licence obligations and the production checklist in
docs/configuration.mdanddocs/operations.md, the code-scanning policy in
SECURITY.md, the relicensing history in the README. DESIGN.mdis in English, and comments, docstrings and log messages acrossapp/,
tests/,scripts/andevals/were trimmed and translated to English. No behaviour
change.- The sign-off check skips Dependabot pull requests.
Fixed
- Search snippets no longer show markdown syntax — table pipes, heading marks, wikilink
brackets or mermaid source. The syntax is stripped before the words are chosen, so ranking
is unchanged (#44). - The graph view's force layout is readable: labels are centred under their node and sized
into the simulation, so they no longer overlap (#45). - The seeded deploy runbook described a retired Gitea runner and SQLite; it now describes the
deployment that exists (#42). scripts/changelog.pyrefusesUnreleasedas a version instead of printing that section
as release notes.
Removed
ROADMAP.mdand.graphifyignore.
Dependencies
reactandreact-dom18.3.1 → 19.3.0 (major).lucide-react1.43.0 → 1.47.0,prettier3.9.6 → 3.9.8.pyjwt2.13.0 → 2.14.0,onnxruntime1.29.0 → 1.30.0,ruff0.16.6 → 0.16.8,
pyright1.1.411 → 1.1.414.- GitHub Actions:
docker/setup-buildx-action4.4.1,docker/build-push-action7.4.0,
docker/setup-qemu-action4.4.0,astral-sh/setup-uv10.1.0.