respec icon indicating copy to clipboard operation
respec copied to clipboard

Notes should include their section title in the note heading

Open jnurthen opened this issue 3 years ago • 0 comments

Is your feature request related to a problem? Please describe. We have a lot of Notes in the ARIA spec which just have the heading Note. This is confusing for screen reader users.

Describe the solution you'd like I know we can use title to add a more specific title but it seems you could often use the previous heading as part of the note heading. So for example the note at https://w3c.github.io/aria/#supportedState could be titled "Note on Supported States and Properties"

Additional context Add any other context or screenshots about the feature request here.

Describe any alternatives you've considered We could use title but that seems like manual work when respec could do it for us.

Can you or your organization fund the work or help with development? I may be able to provide a PR but haven't worked on it yet.

jnurthen avatar Sep 29 '22 17:09 jnurthen