Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Version selector for Nix manual in title bar #836

Open
lf- opened this issue Dec 15, 2023 · 2 comments
Open

Version selector for Nix manual in title bar #836

lf- opened this issue Dec 15, 2023 · 2 comments
Labels
site Improvements to the site infrastructure or content presentation

Comments

@lf-
Copy link
Member

lf- commented Dec 15, 2023

Observations

Currently the Nix docs as seen here don't have the version number switchable and don't raise that you're not looking at the latest: https://nix.dev/reference/nix-manual

Problem

It's hard to navigate between Nix versions docs without knowing what the latest Nix version is.

Approaches

Consider docs.rs or docs.python.org as examples of the solution: there's a drop down in a top bar to select the version and on docs.rs there's a little warning if it's an old version.

This versioning thing could probably be reused for NixOS docs and such.

Willing to help?

Maybe

Priorities

Add 👍 to issues you find important.

@lf- lf- added the site Improvements to the site infrastructure or content presentation label Dec 15, 2023
@henrik-ch
Copy link
Contributor

Further observation:
When navigating from the https://nixos.org/learn page to the manual, the link is https://nixos.org/manual/nix/stable/ .

On the other hand, when navigating from https://nix.dev/reference/nix-manual to 2.19, the link is https://nix.dev/manual/nix/2.19/
I would prefer if we could avoid having the same information available under different top urls - at least to me it's confusing.
On that note, I can't determine if those two links are fully equivalent.

@fricklerhandwerk
Copy link
Collaborator

@henrik-ch #830 is supposed to address that

@asymmetric asymmetric changed the title Version selector for Nix docs in title bar Version selector for Nix manual in title bar Dec 19, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
site Improvements to the site infrastructure or content presentation
Projects
None yet
Development

No branches or pull requests

3 participants