Skip to content

7.2.4. Screen Name/Title: Create a service – Unclear summary text in <summary> element #2336

@whabanks

Description

@whabanks

Component: If you do not have an invitation
Observation:
The <summary> text "If you do not have an invitation" may lack context when read out of its visual surroundings.
Screen reader users may not have full visual context and rely on descriptive, standalone text to understand content.

Recommendation:
Screen reader users often encounter elements like <details>/<summary> out of context, making unclear phrases (e.g., “If you do not have an invitation”) confusing without additional explanation. Unlike sighted users who rely on visual cues, screen reader users need more context to understand the purpose or consequence of such statements.
Instead of relying on visual surroundings, write it so it:
Makes sense on its own
Describes the purpose of the collapsible section
Example:
<summary>If you do not have a GC Notify invitation</summary>
Or
<summary>What to do if you don’t have a GC Notify invitation</summary>

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions