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
Versioned Nix/Nixpkgs/NixOS manuals #1179
Labels
design
About the design refresh work
Comments
12 tasks
There is work going on here: NixOS/nix.dev#764 I also have a draft to port the Nixpkgs and NixOS manuals, but that is more work because it's being processed with a new stylesheet and wrapped with the Perl templating engine used for nixos.org (which only builds on Linux). |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Describe the glitch
The "versioning" of the current URL API for the manuals are merely
stable
andunstable
. For example,All the link to the Nixpkgs manual inside the (NixOS) Release Notes refers to the
unstable
version, making it irrelevant after release branch-off, contradicting the purpose of a release note.This long-lasting issue can be solved by introducing versioned API to access the manual. Namely,
For Nix, which
seems toconforms the Semantic Versioning, a gross version could be redirected to the relevant fine version. For example,could be redirected to
Screenshots
The above screenshot contains the versioned URL typed to the browser address bar:
but the web page shows:
Additional context
Previous discussion: NixOS/nixpkgs#234651 (review)
The text was updated successfully, but these errors were encountered: