posit-dev / posit-dev/open-source-website
Blog post TOC heading is empty
Open
Beginner friendly
Nobody has claimed this yet.
blog
- Dominant language
- HTML
- Stars
- 55
- Forks
- 24
- Avg merge
- 1d 21h
- Merged PRs (30d)
- 17
Description
On blog post pages with a sidebar table of contents, the TOC heading is rendered as an empty <h2 class="blog-toc-heading"></h2>. Both Lighthouse and axe-core (empty-heading, best-practice) flag it — headings with no text content provide no information to assistive tech and break the document outline.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Search for blog-toc-heading in the blog post rendering path and inspect how the sidebar TOC heading is produced. Reproduce the issue on a blog post page, then use Lighthouse and axe-core to confirm the rendered heading is no longer empty and the empty-heading finding is resolved.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- accessibility, frontend, web-dev
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 70/100