arXiv / arXiv/html_feedback

Consider grouping author, title, and date semantically.

Open
#19 0 comments 0 reactions 0 assignees View on GitHub
accessibility figure table
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.