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

New issue

Closed

opened 2026-10-10 16:01:21 +00:00 by tiagoagueda · 1 comment

tiagoagueda commented

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

Owner

Put a circle-question-mark beside the h1 of Documents, Calendar and Your career: hovering shows the helper text (kept for assistive technology, no longer printed under the heading); clicking opens the full help in a drawer on the right. The same as #839 asks for Listings.

What exists today

Calendar: templates/applications/calendar.html:136-142, c-page-title then a helper paragraph (Interviews, reminders, deadlines and closing dates, by day…).
Your career: templates/resume/overview.html:7-16, helper Written once, here. Every CV variant draws on this….
Documents: no section heading yet (#846).
The help system (#302): cotton/help_mark.html, cotton/help_drawer.html, topics in core/help.py:73-146, texts in templates/help/. Every topic today is a Your details card; c-page-title takes no help — #839 adds that.

What would change

Three topics (documents, calendar, career) with their texts, each with its home and back; the helper paragraphs become their summaries.
The pages use #839's c-page-title help.

Depends on #839. tests/test_help_topics.py checks every topic.

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

Put a `circle-question-mark` beside the `h1` of Documents, Calendar and Your career: hovering shows the helper text (kept for assistive technology, no longer printed under the heading); clicking opens the full help in a drawer on the right. The same as #839 asks for Listings. ## What exists today - Calendar: `templates/applications/calendar.html:136-142`, `c-page-title` then a helper paragraph (*Interviews, reminders, deadlines and closing dates, by day…*). - Your career: `templates/resume/overview.html:7-16`, helper *Written once, here. Every CV variant draws on this…*. - Documents: no section heading yet (#846). - The help system (#302): `cotton/help_mark.html`, `cotton/help_drawer.html`, topics in `core/help.py:73-146`, texts in `templates/help/`. Every topic today is a *Your details* card; `c-page-title` takes no help — #839 adds that. ## What would change - Three topics (`documents`, `calendar`, `career`) with their texts, each with its `home` and `back`; the helper paragraphs become their summaries. - The pages use #839's `c-page-title` help. Depends on #839. `tests/test_help_topics.py` checks every topic. Checked against `main` at `8c3d03570`. From the maintainer's improvements list of 2026-10-07.

tiagoagueda added this to the 0.6.0 milestone

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

tiagoagueda added the

enhancement

accessibility

interface

labels

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

tiagoagueda referenced this issue

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

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

tiagoagueda self-assigned this