Consider grouping author, title, and date semantically.
- Dominant language
- No language data
- Stars
- 42
- Forks
- 40
- PR merge metrics
- No merged PRs in 30d
Description
## Problem
Currently, the references section is a list. Each list item represents an article or other publication. Visually, these are grouped further into 1. the author and 2. the title and date.
Semantically, however, the grouping beyond the list item doesn't exist, i.e. the author and date are non-semantic span elements. When using a screen reader, there is no grouping, and the author runs into the title and date, unlike the visual grouping which distinguishes this information.
## Potential Solutions
I would not consider this a major accessibility issue, but it's possible this could be improved using one or more of the following:
- The references could be represented semantically as a table. Visually, they could be styled the same way they are now.
- The references could still be a list. Within the list elements such as dd, dl, etc. could be used to label the author and title sections.
- There is a [
## Other Notes
I would consider this issue a relatively low priority, but I do think the references section could be made more navigable.
This issue raised during accessibility evaluation #18
Contributor guide
Research direction
Start by inspecting the references section and how each list item currently exposes its author, title, and date. Compare the semantic options raised here—table, list with definition elements, and the
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- accessibility
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100