forrtproject / forrtproject/forrtproject.github.io

Fix site-wide heading hierarchy and search widget H1

Open
#860 0 comments 0 reactions 1 assignee Claimed by @LukasWallrich View on GitHub
enhancement new website
Dominant language
HTML
Stars
42
Forks
33
Avg merge
2d 6h
Merged PRs (30d)
19

Description

## Why this needs addressing

The live homepage and glossary pages emit `

Search

` before the page-specific headings. The author template likewise renders the profile name as an `

`, while the search widget remains the first H1. For example, the homepage currently starts with `Search`, followed by several section H1s; `/authors/kimberly-quinn/` has `Search` as its only H1 and the person’s name as an H2.

Relevant implementation: `layouts/partials/search.html` emits the search heading, and `layouts/authors/list.html` renders the profile name.

## Requested change

- Change the search widget heading to an appropriate subordinate heading or an accessible labelled container without changing its visual appearance.
- Give the homepage one meaningful page-level H1 and demote its section headings to H2.
- Promote the author name to H1 on author profile pages.
- Check glossary, resource, taxonomy, and post templates for the same pattern.

## Acceptance criteria

- The first meaningful heading on each representative page describes that page.
- Author profiles have the person’s name as H1.
- Search remains keyboard- and screen-reader-accessible.
- Add a template-level regression check or fixture so the search widget cannot become the page H1 again.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.