NixOS / nix.dev

Official documentation for getting things done with Nix.
https://nix.dev
Creative Commons Attribution Share Alike 4.0 International
2.26k stars 238 forks source link

incorrect redirect for nix manual #1005

Closed raboof closed 2 weeks ago

raboof commented 3 weeks ago

https://nixos.org/manual/nix/unstable/language/builtins#builtins-fetchurl redirects to https://nix.dev/manual/nix/development/language/builtins which then redirects to https://hydra.nixos.org/build/263397466/download/1/manual/language/builtins

I think that should have ended up at https://hydra.nixos.org/build/263397466/download/1/manual/language/builtins.html , but I'm not sure which redirect is wrong :)

fricklerhandwerk commented 3 weeks ago

Yes, all of this is a mess because URL rewriting doesn't work as it's supposed to, neither on the nix.dev side (by Netlify) nor on Hydra (don't even know what that uses, maybe nginx?). All the information required for that is in place though.

What we could do to not have all those redirects constantly broken is

raboof commented 3 weeks ago

What we could do to to not have all those redirects constantly broken is

  • point nixos.org/manual/nix/unstable to the latest Nix release instead of to the master build. It would change semantics

Right: the balance between having updates to the docs quickly available, vs potentially documenting things that aren't actually released yet. Does the nix team have a preference?

fricklerhandwerk commented 3 weeks ago

I'd rather ask what users and contributors prefer. If lots of people live on the bleeding edge and absolutely expect the "unstable" manual to point to master, we better make that work.

fricklerhandwerk commented 2 weeks ago

I took the shortcut by redirecting to the latest release.

Closed by https://github.com/NixOS/nixos-homepage/pull/1486