Advice for new contributors documentation should be structured with headings - Accessibility

[Sarah Sanger]

The ​advice for new contributors documentation page is misusing bold text within list items as headings. This is a common accessibility issue. Though visually the text stands out, for screen reader users all of those guidelines are one big unstructured list. They will get no indication of what’s a heading and what’s the guideline’s contents.

For all users, it would also be very neat to be able to link straight to one of those guidelines. So – we need to replace the bold text with semantic headings (heading level 3)

[Thibaud Colas]

Thank you for the report Sarah! The current pattern is a pretty clear failure of ​WCAG SC 1.3.1 Info and Relationships:

Information, structure, and relationships conveyed through presentation can be programmatically determined or are available in text.

For reference, we also did a similar change in ​PR #17549. Note for the page you mention there seems to be two lists with this issue; under First steps and Guidelines.

[Sarah Boyce <42296566+sarahboyce@…>]

In c4c07622:

Fixed #35863 -- Replaced bold text with heading level 3 in new contributors docs.

This improves accessibility for screen reader users, see WCAG SC 1.3.1 Info and Relationships:
​https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html

[Sarah Boyce <42296566+sarahboyce@…>]

In 08c0c421:

[5.1.x] Fixed #35863 -- Replaced bold text with heading level 3 in new contributors docs.

This improves accessibility for screen reader users, see WCAG SC 1.3.1 Info and Relationships:
​https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html

Backport of c4c076223eb73553d3bc8fbc11be2c529d9aea6b from main.