charmed-kubernetes / kubernetes-docs

This repository contains the development version of docs for Charmed Kubernetes
7 stars 52 forks source link

add new nav #800

Closed evilnick closed 11 months ago

netlify[bot] commented 11 months ago

Deploy Preview for cdk-next ready!

Name Link
Latest commit 8918843f505e6c04baaaba6ecd5d63ca2592b7ec
Latest deploy log https://app.netlify.com/sites/cdk-next/deploys/65253ad50ccf5a00084ca7ad
Deploy Preview https://deploy-preview-800--cdk-next.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Cynerva commented 11 months ago

Having thought about it more, I guess my instinct is that I'd like somewhere to be able to see a list of all how-to guides, and have that list include more specific guides like "How to upgrade to a new version", "How to monitor with Grafana/Prometheus", etc.

At the nav level I imagine something like:

Where basically we pick a handful of the most important or popular how-tos, but tuck the rest under a page that has the full list. For me I think that makes it a lot more obvious where to look - if the specific thing I want to find isn't there on the nav, then "See all how-to guides" is pretty eye-catching as a next place to look, and doesn't require me to think as hard about where the guide could be located. I hope that makes sense.

evilnick commented 11 months ago

@cynerva I don't disagree with your comments, however, this is the structure and layout for the navigation I agreed with D would meet our objective. I suggest that we move forward with this for now and review at some point in the near future to suggest further improvement