knative
Unable to navigate docs on mobile
Expected Behavior
When navigating to the docs section of the website on mobile, I should be able to select the components I want (e.g. functions, serving, etc.)
Actual Behavior
I only see the options in the nav for the sub-categories on the home page of the docs:
Steps to Reproduce the Problem
- Visit the docs page on mobile view
Additional Info
Additional context Add any other context about the problem here.
Install information:
- Platform (GKE, IKS, AKS, etc.):
- Knative Version:
IMO if we can't find a way to solve this before the graduation announcement, we should rollback the docs navigation changes that led to this - otherwise users won't be able to find anything on mobile
Thanks for flagging this! I thought I had tried it earlier and the navigation worked.
/accept
For me, if you select the back arrow in the upper-left you can navigate to the other topics, but I agree that the result is non-optimal (though I'm trying to figure out what the optimal result would be for both showing where you are in the nav and showing the parent topics).
For me, if you select the back arrow in the upper-left you can navigate to the other topics, but I agree that the result is non-optimal
Yeah, that worked for me as well - but the first time I tried the website on mobile that didn't occur to me. My fear is that users will look, and then leave the website when they can't find where they want to go quickly
IMO, if you navigate to the home for the docs on mobile, the side nav should give the "top-level" nav, not the nested nav for that page when you first visit it.
@Cali0707 that might be a mkdocs specific thing - eg. see: https://gateway-api.sigs.k8s.io/
@Cali0707 that might be a mkdocs specific thing - eg. see: https://gateway-api.sigs.k8s.io/
Yeah somewhat, but before we changed how the nav works, when you went to the docs home you could see in the sidebar "Eventing", "Functions", etc.
Now, it is hard to find the docs section you want when you navigate to the "docs". For example, on smaller mobile screens on mobile currently, you can't even find the "docs" tab since it is only in the top nav (which is not correctly responsive):
https://github.com/user-attachments/assets/ff483650-2eef-4b30-ac36-2a1b62f7ae90
Similarly, if you can find the docs tab (slightly wider screen), once you get there it is not really clear how to navigate to the actual docs you are looking for:
https://github.com/user-attachments/assets/f70f9901-30ae-44df-8aae-38f41feb7fcc
Also, needing to move "back" with an error is not intuitive in this case, as you would think that takes you to where you just were - which is "empty" on the home (non-docs) page you navigated from.
I get that the new nav makes the links nicer (and gets rid of the redirect we had from knative.dev to knative.dev/docs), but I don't think that value is worth the loss in usability of the site for mobile users
One thing I noticed - on the home page the nav (in a compressed view) doesn't show anything.
I'm working on this this week; I'm hoping to get the nav working correctly on desktop with the double-bar, and on mobile with only a sidebar (and removing the hard-coding in our site template for the top bar that we do today).
Pulling some stuff from Slack to here as well.
Question: how attached are people to the two top-level navigation bars? If we switch it back to one bar, I think it may be a lot easier to fix some of the mobile nav stuff. The sections would then be in the nav on the left; we might leave items from the non-current section contracted by default (as we do today).
In terms of the top bar responsiveness, with a little playing, I can get the top bar to look like this:
I think that's a straight-up win, so I'm going to PR that.
If we're okay with removing the second-layer top nav and moving it to the left, that would actually simplify some of our layout in general, and move us closer back to the material-mkdocs theme.
I'm not particularly tied to the two top-level nav bars, happy to change it if it makes the mobile nav better.