id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
32860	Improve accessibility of permalinks in Django docs	Tim McCurrach	Tim McCurrach	"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.)"	Bug	closed	Documentation	3.2	Normal	fixed			Accepted	1	0	0	0	0	0