Multiple hyperlinks redirecting to invalid URLs on nixos.org/learn

[dpeachpeach]

Introduce your stance
A number of hyperlinks on the nixos.org website seem to be redirecting incorrectly. I saw that there was a PR that was merged that was supposed to solve this in #1447, but it seems like there still is a problem.

Describe the issue
Multiple links on this page:
https://nixos.org/learn/

Such as all of the ones in this screenshot:

Direct to links such as:
https://nix.dev/manual/nix/2.18/stable/installation/installing-binary. Which returns a page not found error:

When the 'functional' link seems to be:
https://nix.dev/manual/nix/2.18/installation/installing-binary

Page links

• https://nixos.org/learn
• https://nix.dev/manual/nix/2.18/stable/expressions/builtins.html
• https://nix.dev/manual/nix/2.18/installation/installing-binary

Additional context
I know that nix.dev is separate from this website, so I'm not sure where the burden of 'improvement' falls under. However, these links are still broken and I just wanted to alert someone. I could start up a PR to fix this pretty quickly as well if I required but I just wanted to confirm that this wasn't fixed. Thank you!

• I already created a Pull Request

[fricklerhandwerk]

Thanks for reporting, I'll take care of it.

[proofconstruction]

Some context since I've also been hunting for the appropriate fix here:

All of those links are under https://nixos.org/learn/manual/nix/stable which is redirected by

nixos-homepage/public/netlify.toml

Lines 115 to 117 in 5f00e55

	[[redirects]]
	from = "/manual/nix/*"
	to = "https://nix.dev/manual/nix/stable/:splat"

to https://nix.dev/manual/nix/stable/stable.

The first stable gets transformed into the current stable numeric version by mutableRedirect during the nix.dev installPhase; this transformation is reified as a netlify redirect during the CI workflow. The resulting link 404s, as <version>/stable is not a valid path.

This is yet more reason to unify the docs-related infrastructure across repositories; see #1141 for earlier discussion.

[nixos-discourse]

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2024-05-31-documentation-team-meeting-notes-130/46261/1