Handbook skeleton with Zensical, ADR-0024 and publishing in the release skill (#138) #143

Merged
miko merged 3 commits from feature/138-handbook-skeleton into development 2026-11-06 11:00:33 +01:00
Owner

Part of #137, implements #138.

Summary

 handbook/                          # new: Zensical project (ADR-0024)
+├── zensical.toml                  # nav, site_url https://pages.mike-ochmann.de/kataba/, kataba logo
+├── requirements.txt               # zensical==0.1.0, run with uv
+├── docs/
+│   ├── user/        index, reading, authoring       (placeholders)
+│   ├── admin/       index, in-app, operating        (placeholders)
+│   └── stylesheets/kataba.css     # app accent, surface, text in light/dark
+└── overrides/.icons/kataba/logo.svg
 docs/adr/
+└── 0024-handbook-built-with-zensical-published-to-git-pages-by-the-release.md
 .claude/skills/release/SKILL.md    # + build --strict before the release commit, publish from the tag
 README.md  CHANGELOG.md  eslint.config.mjs  .dockerignore

Publishing, as a step of the release skill:

release
  zensical build --strict          # broken link stops the release
  ...tag, Forgejo release, Docker push
  publish handbook from the tag
    build site → force-push as only commit of `pages`
    PUT repo URL to https://pages.mike-ochmann.de/kataba/
      Authorization: Pages <token>   # DNS challenge: TXT _git-pages-challenge.pages.mike-ochmann.de

Evidence

  • Before: no handbook; zensical build --strict with a broken link → page does not exist … Aborted because --strict flag is set, exit 1
    After: uv run --no-project --with-requirements requirements.txt zensical build --strict → No issues found, exit 0. Rendered in Chromium (light and dark): kataba mark in the header, blue accent #1670e8 / #5ca3f5 on neutral surfaces.
  • npm run lint, npm run typecheck, npm test (575 tests) pass.

Merge Danger

Door: two-way

Docs, config and the release skill only; the app is untouched. The handbook is not published by this merge.

Blast Radius: small

The README's Handbook link is a 404 until the first publish, which needs the _git-pages-challenge TXT record and token (setup in the release skill).

🤖 Generated with Claude Code

Part of #137, implements #138. ## Summary ```diff handbook/ # new: Zensical project (ADR-0024) +├── zensical.toml # nav, site_url https://pages.mike-ochmann.de/kataba/, kataba logo +├── requirements.txt # zensical==0.1.0, run with uv +├── docs/ +│ ├── user/ index, reading, authoring (placeholders) +│ ├── admin/ index, in-app, operating (placeholders) +│ └── stylesheets/kataba.css # app accent, surface, text in light/dark +└── overrides/.icons/kataba/logo.svg docs/adr/ +└── 0024-handbook-built-with-zensical-published-to-git-pages-by-the-release.md .claude/skills/release/SKILL.md # + build --strict before the release commit, publish from the tag README.md CHANGELOG.md eslint.config.mjs .dockerignore ``` Publishing, as a step of the release skill: ```text release zensical build --strict # broken link stops the release ...tag, Forgejo release, Docker push publish handbook from the tag build site → force-push as only commit of `pages` PUT repo URL to https://pages.mike-ochmann.de/kataba/ Authorization: Pages <token> # DNS challenge: TXT _git-pages-challenge.pages.mike-ochmann.de ``` ## Evidence - **Before:** no handbook; `zensical build --strict` with a broken link → `page does not exist … Aborted because --strict flag is set`, exit 1 **After:** `uv run --no-project --with-requirements requirements.txt zensical build --strict` → `No issues found`, exit 0. Rendered in Chromium (light and dark): kataba mark in the header, blue accent `#1670e8` / `#5ca3f5` on neutral surfaces. - `npm run lint`, `npm run typecheck`, `npm test` (575 tests) pass. ## Merge Danger **Door:** two-way Docs, config and the release skill only; the app is untouched. The handbook is not published by this merge. **Blast Radius:** small The README's Handbook link is a 404 until the first publish, which needs the `_git-pages-challenge` TXT record and token (setup in the release skill). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
miko merged commit 249de57030 into development 2026-11-06 11:00:33 +01:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
MassiveDynamic/kataba!143
No description provided.