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
37410	Groups in the documentation home page table of contents are not exposed to assistive technology	Natalia Bidart	Natalia Bidart	"The groups on the home page table of contents exist only visually. The label is bold text and the links that follow it are separated by literal `|` characters, so nothing conveys to assistive technology that they belong together:

{{{
* **Getting started**:
  :doc:`/intro/overview` |
  :doc:`Installation </intro/install>`
}}}

As discussed in [https://forum.djangoproject.com/t/a-more-accessible-home-page-table-of-contents/46072/ the forum], we should produce content that semantically reflects the proper hierarchy, independently of how we style it. Nested lists do that, with no extension and no new dependency:

{{{
* **Getting started**

  * :doc:`/intro/overview`
  * :doc:`Installation </intro/install>`
}}}

A screen reader then announces ""Getting started, list with 2 items"" before reading them.

One side effect worth mentioning is that the docs home page has 159 links in 39 groups, so one per line would lose the compact map. Keeping it needs a small rule in `docs/_static/` (`display: inline` plus a generated separator), with a companion change on djangoproject.com, which has its own stylesheet.

Related to #37409 and #37051."	Bug	assigned	Documentation	dev	Normal		accessibility	Mike Edmunds Daniele Procida	Accepted	0	0	0	0	0	0