json-schema-org / json-schema-org/website

🐛 Bug: Section header does not highlight when navigating from Table of Contents

Open
#2,335 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

🐛 Bug Status: Triage
Dominant language
HTML
Stars
169
Forks
484
Avg merge
2d 2h
Merged PRs (30d)
6

Description

Describe the bug

When clicking an item in the Table of Contents, the page scrolls to the corresponding section correctly. However, the header of that section does not change color or highlight to indicate that it is the active section. This makes it difficult for users to visually identify the currently focused section.

Steps To Reproduce
  1. Go to the https://json-schema.org/learn/getting-started-step-by-step#introduction-to-json-schema
    2.Scroll down to the Table of Contents.
  2. Click on any item from the list.
  3. The page scrolls to the corresponding section.
  4. Observe that the header of that section does not change color to indicate it is active.
Expected Behavior

When a user clicks on an item in the Table of Contents, the page should scroll to the corresponding section and the header of that section should change color to indicate it is the active section.

Screenshots

https://github.com/user-attachments/assets/f950ccfc-0682-4696-aa72-7ab41f34ff22

Device Information [optional]
- OS:
- Browser:
- version:
Are you working on this issue?

No

Do you think this work might require an [Architectural Decision Record (ADR)]? (significant or noteworthy)

Yes

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue on the linked getting-started-step-by-step page by selecting entries in the Table of Contents. Inspect the Table of Contents and section-header behavior around the linked introduction-to-json-schema anchor, then verify that the selected section header receives the expected visual highlight after navigation.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
frontend
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.