Skip to content

Difficult to get to the library repo from the docs pages #1177

Open

Description

@SeanCassiere

When on a library's landing page, its easy to get to the library repo through the Github link in the sidebar.

Image

But when on an actual doc page, it becomes difficult to get to the repo then.

Image

We should make it easy to get to the repo.

This comes from live feedback in a call with Derek who bounced off of the website to go Google to then find the repo.

Activity

  1. tannerlinsley commented on Aug 25, 2026

    @tannerlinsley
    Member

    @tannerlinsley Source audit evidence: the repository URL already exists in useMenuConfig, but it is nested under the generic Menu group. The only direct repository link in the docs tab bar is the Built in public link, and that block renders only when isLandingPage is true. This matches the reported behavior: once someone opens a docs page, the repo is still available, but only after discovering and opening Menu.

    Expected impact: a persistent repository affordance would remove a documented navigation dead end for people moving from docs to source or issues.

    Proposed direction: reuse the existing repo value and show a clearly named GitHub link in the docs top bar on non-landing pages at desktop widths, while keeping the current menu item as the mobile and compact fallback. This is smaller than redesigning the full docs navigation and does not introduce a second source of repository metadata.

    Alternatives: put the link in the right rail, which is not available at all viewport sizes, or rename/restructure the generic Menu, which changes a broader navigation contract.

    Decision needed: should non-landing docs pages get the direct top-bar GitHub link, or should repository access remain inside a redesigned Menu surface?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    source-auditTracked by the automated source audit

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions