pypi/warehouse

The structure of the different headings is incorrect

Open

#18,162 opened on May 20, 2025

View on GitHubContributor guide
 (6 comments) (0 reactions) (0 assignees)Python (1,201 forks)auto 404
HTMLUX/UIaccessibilitygood first issuehelp needed

Repository metrics

Stars
 (4,097 stars)
PR merge metrics
 (PR metrics pending)

Description

Hi, I have seen an issue in the ordering of the headings in the project which impact all project under the warehouse. This is an issue in terms of accessibility.

"Navigation" should be a heading level 2 according the structure of the website.

"Project link" is a heading level 6 but I can't see any heading level 4 and 5 before, it should be a heading just under "Verified details", which is a heading level 3 for now. The same applies for the similar headings as showed in the screenshot with the tool I have used.

Screenshot:

Image

Contributor guide

Research direction
Identify the template files in the Warehouse project that render the 'Navigation', 'Project link', and 'Verified details' headings. Adjust the heading levels to follow a correct hierarchical structure (e.g., 'Navigation' should be h2, 'Project link' should be h4 below 'Verified details' h3). Ensure consistency across similar headings in the UI.
Tech stack
pythonhtml
Domain
frontendaccessibility
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
HTMLaccessibility basics
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
90