Skip to content

UI Improvement: Table of Contents not filtered by selected language #1089

@ravixalgorithm

Description

@ravixalgorithm

While exploring the ADK documentation, I noticed a small UI inconsistency in the “Build a multi-tool agent” and some other pages.

When a specific language (e.g., Python, TypeScript, or Java) is selected, the Table of Contents still displays entries for all languages instead of showing only the sections relevant to the selected language.

This can be slightly confusing for readers, especially beginners, as the ToC suggests content that isn’t currently visible or applicable.

Expected Behavior

The Table of Contents should dynamically update to show only the sections corresponding to the currently selected language.

Actual Behavior

The Table of Contents includes entries for all languages regardless of the selected language tab.

Why this matters

  • Improves clarity and focus while reading docs
  • Reduces cognitive load for new users
  • Aligns ToC behavior with the selected language context

Proposed Solution (Optional)

Conditionally render or filter the Table of Contents based on the active language selection.

Additional Context

This seems like a minor UI enhancement, but it could significantly improve the documentation experience.
I’m a beginner in open source and would love to take this up as a starter contribution if the maintainers are open to it. I’m happy to follow the project’s contribution guidelines and feedback.

Screenshot

Image

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions