ENH-176: Rollback Bold Font in Decision Records Overview Table ¶
1 Status ¶
| Date | Status | |
|---|---|---|
| 20-05-2026 | Proposed | |
| 20-05-2026 | Accepted | |
| 20-05-2026 | In-Progress | |
| ▶ | 20-05-2026 | Implemented |
2 Context ¶
ENH-173 introduced bold font in the Decision Records Overview page (build/decisions/overview.html) for column headers, the # cell, and the Title cell — via three CSS rules scoped to table.controlled.decisions_overview.
After using the Almirah tool on real projects, the bold styling visibly contradicts the Specifications Index and other index pages, which render their table.controlled tables in normal weight. The overview now looks heavier than every other index page in the same build.
3 Decision ¶
Rollback all bold-font styling introduced by ENH-173 in the Decision Records Overview table. The overview shall render headers and all body cells in normal weight, matching the other index pages.
Remove the three CSS rules from lib/almirah/templates/css/main.css:
table.controlled.decisions_overview th { font-weight: bold; }table.controlled.decisions_overview td.item_id { font-weight: bold; }table.controlled.decisions_overview td.item_text { font-weight: bold; }
The decisions_overview class on the table element is retained — it is still useful as an opt-in hook for future per-overview styling, and is also used by enh-175-overview-sort-id context.
4 Scope ¶
| Item | Status | Start Date | Target Date | Description |
|---|---|---|---|---|
| Code | Done | 20-05-2026 | 20-05-2026 | Three font-weight: bold rules scoped to table.controlled.decisions_overview removed from main.css |
Cosmetic change — no requirements or end-to-end tests added.
5 Out of Scope ¶
- Removal of the
decisions_overviewCSS class itself. - Changes to other ENH-173 outcomes: clickable
#hyperlink, three appended columns (Start Date,Target Date,Owner), and sort order from enh-175-overview-sort-id all remain. - Bold styling in any other page or table.
6 Consequences ¶
6.1 Positive ¶
- Decision Records Overview visually matches the Specifications Index and other index pages.
6.2 Negative ¶
- Loss of the visual hierarchy added by ENH-173 (headers and
Titleno longer stand out). Accepted as the price of cross-page consistency.
6.3 Neutral ¶
- The
decisions_overviewclass remains available for future scoped styling.
7 Alternatives Considered ¶
- Bold the headers/Title across all index pages instead. Rejected: wider change than the observed UX issue requires; consistency restored by rolling back is sufficient.
8 Software Versions ¶
| Software Version Category | Software Version ID |
|---|---|
| Latest Released Version | 0.3.1 |
| Issue Found in Version | 0.4.0 |
| Target Release Version | 0.4.0 |
9 References ¶
- ENH-173 — introduced the bold styling being rolled back here
- ENH-175 — adjacent overview-page enhancement