feat: improve display of releases in navbar

[tuananh]

Signed-off-by: Tuan Anh Tran [email protected]

1. Issue, if available:

#826

2. Description of changes:

show the latest version in navbar + style pre-release in gray color

3. Does this change impact docs?

• Yes, PR includes docs updates
• Yes, issue opened: link to issue
• No

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[netlify]

✔️ Deploy Preview for karpenter-docs-prod ready!

🔨 Explore the source changes: e727612

🔍 Inspect the deploy log: https://app.netlify.com/sites/karpenter-docs-prod/deploys/61aedd5a14b7c40007fea3df

😎 Browse the preview: https://deploy-preview-906--karpenter-docs-prod.netlify.app

[tuananh]

@geoffcline can you take a look?

[tuananh]

@geoffcline

1. i did a hack by patching docsy theme. Lemme see if i can upstream this change so we don't have to keep the patch here. basically, what it does is trying to get the path dir and see if it matches with any of the docs folder and display the {{ .version }} there.
2. i remove pre-release as well as the gray out css bit. since we dont have pre-release, so its' not needed right?

when browsing in /docs/....

when browsing in older docs

[tuananh]

i think i need to update netlify.toml too to apply the patch for preview. apparently, it's not using make website command

EDIT: netlify works now

[akestner]

Will this ensure that the docs version dropdown is visible on mobile devices as well?

[tuananh]

Will this ensure that the docs version dropdown is visible on mobile devices as well?

no. the navbar is kind of jammed right now. in order to show version, we may have to hide other links. what do you think we should hide under hamburger menu?

ok now ;)

[tuananh]

Will this ensure that the docs version dropdown is visible on mobile devices as well?

it should show on mobile as well now

[rothgar]

This lgtm. Is the pre-release version added to config.toml manually when we have one to deploy?

I don't see any problem carrying the patch in layouts/partials because that's where you're supposed to modify/extend docsy anyway. It would be nice to be an option upstream but I don't think it should block this PR if it's not there.

[chrisnegus]

@geoffcline have all your issues been addressed? If so, /lgtm from me.

[geoffcline]

Wonderful, thank you!