Documents: the pages have no “Documents” heading #846

New issue

Closed

opened 2026-10-10 16:01:20 +00:00 by tiagoagueda · 0 comments

tiagoagueda commented

2026-10-10 16:01:20 +00:00

Owner

The Documents pages have no h1 that says Documents.

What exists today

Each page's h1 names its list, after the Documents navigation strip:

Page	`h1`
`templates/documents/cv_list.html:17`	CVs and portfolios
`templates/documents/letter_list.html:12`	Letters
`templates/documents/upload_list.html:12`	Files
`templates/documents/rendered_list.html:10-18`	Sent documents

The word appears only as the navigation's landmark name (cotton/documents_nav.html:5). Every other section (Listings, Applications, Companies, Calendar) has its name as the h1.

What would change

One h1 Documents above the strip on all four pages; each list's name becomes an h2.

Decisions

Which heading carries the help mark (#847): recommended the Documents h1, one topic for the section.
The page <title> keeps the list's name (Letters — Documents — instance). Recommended.

Checked against main at 8c3d03570. From the maintainer's improvements list of 2026-10-07.

The Documents pages have no `h1` that says *Documents*. ## What exists today Each page's `h1` names its list, after the Documents navigation strip: | Page | `h1` | | --- | --- | | `templates/documents/cv_list.html:17` | CVs and portfolios | | `templates/documents/letter_list.html:12` | Letters | | `templates/documents/upload_list.html:12` | Files | | `templates/documents/rendered_list.html:10-18` | Sent documents | The word appears only as the navigation's landmark name (`cotton/documents_nav.html:5`). Every other section (Listings, Applications, Companies, Calendar) has its name as the `h1`. ## What would change - One `h1` *Documents* above the strip on all four pages; each list's name becomes an `h2`. ## Decisions - **Which heading carries the help mark** (#847): recommended the *Documents* `h1`, one topic for the section. - **The page `<title>`** keeps the list's name (*Letters — Documents — instance*). Recommended. Checked against `main` at `8c3d03570`. From the maintainer's improvements list of 2026-10-07.

tiagoagueda added this to the 0.5.0 milestone

2026-10-10 16:01:20 +00:00

tiagoagueda added the

bug

accessibility

interface

labels

2026-10-10 16:01:20 +00:00

tiagoagueda referenced this issue

2026-10-10 16:01:59 +00:00

Help beside the heading on Documents, Calendar and Your career #847

tiagoagueda self-assigned this