docs icon indicating copy to clipboard operation
docs copied to clipboard

Page title is hidden when scrolled on mobile

Open thisisobate opened this issue 4 months ago • 7 comments

Expected Behavior

Page title should be visible when page is scrolled down on mobile devices

Actual Behavior

Page title is hidden

Steps to Reproduce the Problem

  1. Navigate to the concepts page
  2. Scroll from top nav to bottom
  3. See how title in top nav is hidden

Install information:

  • Knative Version: Pre-release

thisisobate avatar Aug 13 '25 12:08 thisisobate

Hi @thisisobate I visited the page and checked the state, it is same for all the pages, so I guess it is intended and not a bug.

codeEvolveZenith345 avatar Nov 01 '25 05:11 codeEvolveZenith345

Hi @evankanderson can you take a look at the page and give verdict over its validation as a bug or intended behaviour?

https://knative.dev/docs/

thank you.

codeEvolveZenith345 avatar Nov 01 '25 05:11 codeEvolveZenith345

Screenshot_20251103-160633.Arc Search.png

Suggests that this is not fixed.

I suspect the fix is to undo a lot of the "double nav bar" work which was done to fit the top-level sections and the different documentation sections into the top bar. They basically only considered desktop, so mobile loses both the page title and makes the nav pretty confusing.

evankanderson avatar Nov 04 '25 00:11 evankanderson

Hi @evankanderson thank you for clarifying, I was referencing the page on desktop and not on phone, so I did not get that view. If you would like to get this fixed then please do assign it to me, I will find an optimal fix, and based on your approval of my implementation, I will move forward!

Thank you.

codeEvolveZenith345 avatar Nov 04 '25 06:11 codeEvolveZenith345

/assign @codeEvolveZenith345

evankanderson avatar Nov 07 '25 20:11 evankanderson

Hi @evankanderson Thank you for the assignment, I expect particular/expected design patters to be followed for implementation for references, Please give a high-level implementation overview for an optimal fix!

thank you.

codeEvolveZenith345 avatar Nov 10 '25 09:11 codeEvolveZenith345

Sorry for the late follow-up!

Material for Mkdocs has a navigation.tabs feature that should do a lot of this, but (with the best of intentions) we ended up creating a second set of tabs in the header bar. I think if we can remove that customization, the narrow-window mobile navigation overlaps should be removed.

Note that we will still need to do some form of customization of the navigation, because the actual structure of the build documents is:

  • (root)
    • Current Version Docs
    • About
    • Blog
    • Community
    • Previous Version Docs
    • N-2 Version Docs
    • Pre-release Docs

We collapse all the "Version Docs" into a single "Docs" header predicated on the selected version, while "About", "Blog", and "Community" have non-versioned navigation, because those components aren't really versioned in the same way the technical documentation (under docs/versioned in the repo) is.

evankanderson avatar Nov 15 '25 00:11 evankanderson