Task: Add book entity chapter to the user manual
This page documents a task in the Commission: book story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Add a chapter for Book to the user manual documenting the Qt list, detail, and history windows and their behaviours, matching the style of existing entity chapters.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Commission: book |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-07-08 |
Acceptance
[X]Manual chapter exists for Book covering list/detail/history windows; site builds cleanly.
Plan
(Implementation strategy. Written when work starts; key decisions
are distilled into the parent story's * Decisions at close, but the
plan itself stays — it is the historical record of what we did.)
Notes
PRs
| PR | Title |
|---|---|
| #1466 | [doc,ores.qt] Books manual chapter and domain knowledge cluster |
Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|
Result
Added chapter_7_books.org (list/detail/history windows, 5 screenshots), wired into user_manual.org. While capturing screenshots, found and fixed a real gap: the badge item delegate only coloured popup rows, not the closed-box display – added OreBadgeComboBox (promoted marker class whose paintEvent renders the current selection as a badge pill too). Also split the freeform Book domain notes into an 8-doc Zettelkasten knowledge cluster under doc/knowledge/domain/, reviewed book.org against it, and filed the Book data model cleanup story/tasks plus 4 product-backlog captures for what that review surfaced.