User handbook for readers and authors (#141) #145

Merged
miko merged 1 commit from feature/141-user-handbook into development 2026-11-06 11:33:57 +01:00
Owner

Closes #141. Part of #137.

Writes the two user handbook pages, illustrated with the screenshots from #140:

  • Reading guides (handbook/docs/user/reading.md): categories, search, the menu, the guide header, steps with step images, annotations, step lines and callouts, the step-by-step view, print and PDF, QR-code labels, signing in and roles, language and theme.
  • Writing guides (handbook/docs/user/authoring.md): creating and duplicating a guide, the editor and saving, steps, step images, step lines, step content, annotations, the General/Details/Media tabs, drafts, preview, publishing, working copy and version history (ADR-0020), unpublishing and deleting, visibility (ADR-0002), ownership and wiki mode (ADR-0003), guide packages (ADR-0022).

The ticket lists columns and attachments under rich text, but guides have no columns (they are page-only, PAGE_BLOCKS), and attachments belong to the guide in the Media tab; the handbook says so. The link to pages points at the administration handbook's index until #139 adds the section.

zensical build --strict passes.

🤖 Generated with Claude Code

Closes #141. Part of #137. Writes the two user handbook pages, illustrated with the screenshots from #140: - **Reading guides** (`handbook/docs/user/reading.md`): categories, search, the menu, the guide header, steps with step images, annotations, step lines and callouts, the step-by-step view, print and PDF, QR-code labels, signing in and roles, language and theme. - **Writing guides** (`handbook/docs/user/authoring.md`): creating and duplicating a guide, the editor and saving, steps, step images, step lines, step content, annotations, the General/Details/Media tabs, drafts, preview, publishing, working copy and version history (ADR-0020), unpublishing and deleting, visibility (ADR-0002), ownership and wiki mode (ADR-0003), guide packages (ADR-0022). The ticket lists columns and attachments under rich text, but guides have no columns (they are page-only, `PAGE_BLOCKS`), and attachments belong to the guide in the Media tab; the handbook says so. The link to pages points at the administration handbook's index until #139 adds the section. `zensical build --strict` passes. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Reading guides covers finding guides (categories, search, the menu),
reading one (steps, step images and annotations, step lines, callouts),
the step-by-step view, print and PDF, labels, signing in, language and
theme. Writing guides covers creating a guide, the editor, steps, step
images, step lines and step content, annotations, the properties tabs,
drafts, publishing, the working copy and version history, visibility,
ownership and wiki mode, and guide packages; illustrated with the
screenshots from #140.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
miko merged commit bef196aaa4 into development 2026-11-06 11:33:57 +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!145
No description provided.