Reference Documents UI restack

Overview

The Reference Documents accordion on the project detail page used to render rows in a split TYPE / FILENAME column layout, with the document type bolded and the filename muted. The expanded detail panel was a borderless table with one row per metadata field (Download, Original Name, Version, Category, Sub-category, Created at, Updated at).

Release 3.10 restacks both the row and the expanded panel for a denser, more scannable layout that puts the filename - the field people actually look for - first.

Row layout (collapsed accordion item)

Before:

| TYPE             | FILENAME                  |          |
| Design           | WF-Nth_DG7_Apr2023.pdf    | [⬇][⌄]   |
| Guidelines       |                           |          |

After:

| WF-Nth_DG7_Apr2023.pdf                       | [⬇] [⌄]  |
| (italic, muted) Design Guidelines            |          |

• Single column for the file block.
• Filename bold + black on top.
• Document type italic + muted, on the line below.
• Action icons (history, download) and the collapse-marker chevron move to the right of the row.
• Single-column "FILE" header was added in an interim cut and then dropped after the row layout proved self-explanatory.

Expanded panel (when a row is expanded)

Before: a 2-column borderless table with seven rows of label / value.

After: a vertically stacked block with sectioned label-value pairs:

[Download icon] Download      <- single icon-link, no separate "Download" label

File: V1
WF-Nth_DG7_Apr2023.pdf
Design Guidelines (or subcategory if present)

Created
01/04/2026

Updated
01/04/2026

• The "Download" row is now an icon-led link with no separate label.
• File version is folded into the inline label File: V{n}, with the filename as the value below.
• Subcategory (or category as fallback) appears under the filename only if present.
• Created and Updated dates are stacked label-over-value blocks.
• Empty fields collapse out so the panel stays compact for sparse documents.

Where it shows up

Both the Admin and Customer project detail pages render the same _documents_panel.html.twig. The change applies uniformly across both.

Verification

Browser-verified on production after deploy. The Reference Documents accordion on a Trello-tracked test project rendered with the new row layout and the new expanded panel; download icon-link works; collapse chevron rotates correctly.

Related

• Git tag v3.13.4 (row layout).
• Git tag v3.13.5 (expanded panel restack + interim "FILE" header dropped).