#35863: Advice for new contributors documentation should be structured with
headings - Accessibility
-------------------------------------+-------------------------------------
Reporter: Sarah Sanger | Type:
| Cleanup/optimization
Status: new | Component:
| Documentation
Version: 5.1 | Severity: Normal
Keywords: Accessibility | Triage Stage:
Documentation Contributing | Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 1
-------------------------------------+-------------------------------------
The [https://docs.djangoproject.com/en/5.1/internals/contributing/new-
contributors/ 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)
--
Ticket URL: <https://code.djangoproject.com/ticket/35863>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/django-updates/01070192c0693723-ca25f205-eb51-4c1c-85b4-c6b713b5707e-000000%40eu-central-1.amazonses.com.
