Your details: a question mark beside the heading and on every section, and no helper text under any heading #918

New issue

Closed

opened 2026-10-15 17:19:39 +00:00 by tiagoagueda · 0 comments

tiagoagueda commented

2026-10-15 17:19:39 +00:00

Owner

On Your details, help follows one pattern everywhere. A question mark (Lucide circle-question-mark) follows the page's H1, and one sits at the top right of every section. Each shows its one sentence as a Basecoat tooltip on hover and focus, and the full help in a Basecoat drawer when pressed. No helper text sits under the H1 or under any section's heading.

What exists today

The H1 (templates/accounts/profile.html, top): <c-page-title> with a subtitle slot holding "What Postulo knows about you as a candidate: … under Settings." There is no question mark. <c-page-title help="…"> already draws exactly the requested pattern (#839, used on Listings; #847 on Documents, Calendar and Your career): the mark beside the H1, the topic's sentence as its tooltip, the topic in <c-help-drawer>. Your details has no page topic in core/help.py.
Sections with a mark already (#302): Your picture, Your name and Contact block (<c-section-title help="…">), and Telephone numbers, Postal addresses, the three link cards and Identifiers (<c-help-mark> after the <legend>). With scripts on, their sentence is the mark's tooltip.
Sections without one, with text under the heading instead:
- Your CV photo: <c-section-title> with a subtitle ("A photograph for your CVs, kept apart from your picture. …").
- Personal details: <c-section-title anchor="section-personal"> and a paragraph #personal-details-help ("All optional, and none of it is worked out …"). The fieldsets point at it with aria-describedby.
- Messaging (partials/messaging_handles.html): a <legend>, no mark, no help topic.
Instructions deliberately kept in sight under a heading (#302 kept "what may be typed" visible): Identifiers data-identifiers-how ("An address on … can be pasted whole"), and each link card's data-links-how.
On a phone (reported): the H1 shows neither the helper text nor a question mark. Not reproduced here. <c-page-title> has no rule hiding the subtitle by width, so check what hides it.

What would change

A your-details topic in core/help.py. Its one sentence and full text come from today's subtitle, which is rewritten as help. The H1 becomes <c-page-title help="your-details"> and the subtitle goes. The link to Settings moves into the drawer.
Topics for Your CV photo, Personal details and Messaging, and help="…" (or <c-help-mark>) on each. The Personal details paragraph becomes that topic's sentence. Keep the aria-describedby from the fieldsets pointing at it, as Your name's menus do with tip.
The mark sits at the top right (inline end) of every section, inside the card. The fieldset cards change shape in #919. Until that lands, the mark keeps today's fieldset position.
The two kept-in-sight instructions (data-identifiers-how, data-links-how) move into the tooltip or the drawer. This reverses #302's "an instruction stays in sight" for these two cards, so say which in the topic text.
While something on the page has been refused (refused), the sentences stay under the headings as now (in_sight). That rule is unchanged.
The same pattern is drawn on a phone. The mark and its 24px target are visible at every width.

Accessibility

Each mark is a link or button named "Help:
" (as <c-help-mark> does), described by its sentence. The tooltip shows on focus as well as hover and dismisses with Escape (SC 1.4.13). The drawer is a dialog that traps and returns focus. With scripts off, the mark opens the topic's page (core:help_topic) in a new tab, as now.

Notes

New topics and the rewritten texts are new strings for the catalogues and Weblate. The removed subtitle and paragraph go out of the catalogues.

Related: #302, #839, #847.

Checked against main at 56fc9d531.

On *Your details*, help follows one pattern everywhere. A question mark (Lucide `circle-question-mark`) follows the page's H1, and one sits at the top right of every section. Each shows its one sentence as a Basecoat tooltip on hover and focus, and the full help in a Basecoat drawer when pressed. No helper text sits under the H1 or under any section's heading. ## What exists today - **The H1** (`templates/accounts/profile.html`, top): `<c-page-title>` with a `subtitle` slot holding "What Postulo knows about you as a candidate: … under Settings." There is no question mark. `<c-page-title help="…">` already draws exactly the requested pattern (#839, used on Listings; #847 on Documents, Calendar and Your career): the mark beside the H1, the topic's sentence as its tooltip, the topic in `<c-help-drawer>`. Your details has no page topic in `core/help.py`. - **Sections with a mark already** (#302): *Your picture*, *Your name* and *Contact block* (`<c-section-title help="…">`), and *Telephone numbers*, *Postal addresses*, the three link cards and *Identifiers* (`<c-help-mark>` after the `<legend>`). With scripts on, their sentence is the mark's tooltip. - **Sections without one, with text under the heading instead:** - *Your CV photo*: `<c-section-title>` with a `subtitle` ("A photograph for your CVs, kept apart from your picture. …"). - *Personal details*: `<c-section-title anchor="section-personal">` and a paragraph `#personal-details-help` ("All optional, and none of it is worked out …"). The fieldsets point at it with `aria-describedby`. - *Messaging* (`partials/messaging_handles.html`): a `<legend>`, no mark, no help topic. - **Instructions deliberately kept in sight under a heading** (#302 kept "what may be typed" visible): *Identifiers* `data-identifiers-how` ("An address on … can be pasted whole"), and each link card's `data-links-how`. - **On a phone** (reported): the H1 shows neither the helper text nor a question mark. Not reproduced here. `<c-page-title>` has no rule hiding the subtitle by width, so check what hides it. ## What would change - A `your-details` topic in `core/help.py`. Its one sentence and full text come from today's subtitle, which is rewritten as help. The H1 becomes `<c-page-title help="your-details">` and the subtitle goes. The link to Settings moves into the drawer. - Topics for *Your CV photo*, *Personal details* and *Messaging*, and `help="…"` (or `<c-help-mark>`) on each. The *Personal details* paragraph becomes that topic's sentence. Keep the `aria-describedby` from the fieldsets pointing at it, as *Your name*'s menus do with `tip`. - The mark sits at the top right (inline end) of every section, inside the card. The fieldset cards change shape in #919. Until that lands, the mark keeps today's fieldset position. - The two kept-in-sight instructions (`data-identifiers-how`, `data-links-how`) move into the tooltip or the drawer. This reverses #302's "an instruction stays in sight" for these two cards, so say which in the topic text. - While something on the page has been refused (`refused`), the sentences stay under the headings as now (`in_sight`). That rule is unchanged. - The same pattern is drawn on a phone. The mark and its 24px target are visible at every width. ## Accessibility - Each mark is a link or button named "Help: <section>" (as `<c-help-mark>` does), described by its sentence. The tooltip shows on focus as well as hover and dismisses with Escape (SC 1.4.13). The drawer is a dialog that traps and returns focus. With scripts off, the mark opens the topic's page (`core:help_topic`) in a new tab, as now. ## Notes - New topics and the rewritten texts are new strings for the catalogues and Weblate. The removed subtitle and paragraph go out of the catalogues. Related: #302, #839, #847. Checked against `main` at `56fc9d531`.

tiagoagueda added the

accessibility

enhancement

interface

labels

2026-10-15 17:19:39 +00:00

tiagoagueda referenced this issue

2026-10-16 13:22:16 +00:00

Phones, addresses and social profiles: one behaviour for companies, contacts and Your details #934

tiagoagueda referenced this issue from a commit

2026-10-19 17:13:32 +00:00

Your details: a question mark beside the heading and on every section