Task: Write party_status manual chapter
Table of Contents
This page documents a task in the Commission: party, counterparty, and party_status story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Audit the Parties manual chapter for coverage of party_status (and, discovered along the way, its two sibling lookups party_type and party_id_scheme): add sections documenting their list/detail windows, with real screenshots, wired into the chapter at the point each lookup is first used rather than as a bolted-on afterword.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Commission: party, counterparty, and party_status |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-07-18 |
Acceptance
- party_status, party_type, and party_id_scheme all documented in the Parties chapter with real screenshots, integrated into the domain prose rather than segregated into a separate section.
- All figures resolve in both the PDF and Qt-embedded help; List of Figures entries confirmed.
- Regressions found along the way (missing Display Order field, missing lookup toolbar buttons) fixed rather than glossed over.
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
Test Scenarios
Manual QA scenarios (scaffolded via compass add test_scenario, run
through the QA Validation Runner panel) that verify this task. Link
new ones here as they're created; the scenario doc itself links back
via its "Verifies task" field.
| Scenario | State | Notes |
|---|---|---|
| Capture screenshots for the auxiliary-lookup sections of the Parties manual chapter | PASSED |
PRs
| PR | Title |
|---|---|
Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|
Result
Audited the Parties manual chapter for coverage of party_status (discovered along the way: also party_type and party_id_scheme, its two sibling lookups) and added it, following the user's feedback to merge domain prose with the screens rather than keep them fully separated:
- "Party types and statuses" folds the type/status configurable-lookup concept together with its screenshots, right where type/status are first introduced.
- The Identifiers tab section now carries the ten-scheme table, the GLEIF/LEI/BIC tangent (moved here from "What is a Party?" per feedback), and the Party Id Schemes configurability screens all together, instead of a separate "Identification schemes" section appearing after Contact Information.
- The Hierarchy tab section now carries the house-root/single-root domain rule directly, instead of a separate "The party hierarchy" section appearing chapters earlier with its screenshot chapters later.
Six new screenshots captured, cropped, and wired in (Party Types list/detail, Party Statuses list/detail, Party Id Schemes list/detail). Two real gaps found and fixed along the way rather than glossed over:
- PartyTypeDetailDialog was missing the Display Order field
(party_type.org never had a
*** Detail fieldstable, unlike its siblings) — added it, regenerated, verified zero-extra-diff. - Party/Counterparty windows had no toolbar shortcut to their auxiliary lookups, unlike Currency's Rounding/Monetary Natures/Market Tiers precedent — implemented via the existing codegen paste-block seam (modeled properly, not hand-copied), wired through RefdataPlugin, manually smoke-tested.
Manual PDF and Qt-embedded help both rebuilt; all figures resolve and appear in the List of Figures; reviewed rendered PDF pages directly.