#32860: Improve accessability of permalinks in django docs
-----------------------------------------+------------------------
               Reporter:  Tim McCurrach  |          Owner:  nobody
                   Type:  Uncategorized  |         Status:  new
              Component:  Documentation  |        Version:  3.2
               Severity:  Normal         |       Keywords:
           Triage Stage:  Unreviewed     |      Has patch:  0
    Needs documentation:  0              |    Needs tests:  0
Patch needs improvement:  0              |  Easy pickings:  0
                  UI/UX:  0              |
-----------------------------------------+------------------------
 In the docs generated via `make html`:
  - The permalinks are not focusable
  - This is because they are hidden via `visibility:hidden`, and hidden
 elements are not focusable.

 This provides a bad experience for people using the keyboard to navigate
 through the document.

 The version of the docs generated for `djangoproject.com` is slightly
 better:
  - It uses `opacity:0` to hide them.
  - This means they are focusable.
  - Currently they are still not visible when focused though.

 This provides a confusing experience for sighted users who prefer keyboard
 navigation for accessability (or other) reasons. It means that when you
 'tab through' the page, the focus seems to 'disappear' before re-appearing
 some number of tabs later.

 I propose we update the CSS in both locations to provide focusable
 permalinks that are also visible whilst focused.

 (I appologise if this is not the correct place to raise issues about
 djangoproject.com - I wasn't sure. But since it relates to the docs
 anyway, I figured there would be no harm in doing so.)

-- 
Ticket URL: <https://code.djangoproject.com/ticket/32860>
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 on the web visit 
https://groups.google.com/d/msgid/django-updates/056.93da228e9a21516f59d136fe46241439%40djangoproject.com.

Reply via email to