🚀 Deployed on https://5f4044ea2ae35c0090294c7e--nixos-homepage.netlify.app

I guess the selector is WIP and unfinished?

Or is it a bug?

The requested content at /manual/nixos/unstable could not be found.

https://nixos.org/manual/nixos/unstable

The requested content at /manual/nixos/unstable could not be found.

https://nixos.org/manual/nixos/unstable

See the "Drop the protocol and domain name from href" comment that explains why this happens. Basically the switcher links always point to the nixos.org domain even when served on another domain. (Assuming you got this using the switcher.)

🚀 Deployed on https://5f43aa098ef4eb5f2c99c7f2--nixos-homepage.netlify.app

🚀 Deployed on https://5f43aa3905ebe98f0aed8fb2--nixos-homepage.netlify.app

I guess the selector is WIP and unfinished?

Or is it a bug?

It looks like style is not applied. /me checks

🚀 Deployed on https://5f43abb41d6961017b675eb7--nixos-homepage.netlify.app

In addition to /manual/nixos/stable, maybe we should also have /manual/nixos/20.03 etc. like the Postgres manuals, which have https://www.postgresql.org/docs/12/index.html and https://www.postgresql.org/docs/current/index.html.

🚀 Deployed on https://5f43c19abef76367dd1cb2cc--nixos-homepage.netlify.app

@edolstra

In addition to /manual/nixos/stable, maybe we should also have /manual/nixos/20.03 etc. like the Postgres manuals, which have https://www.postgresql.org/docs/12/index.html and https://www.postgresql.org/docs/current/index.html.

Should we redirect /manual/nixos/20.09 to /manual/nixos/unstable or /manual/nixos/unstable to /manual/nixos/20.09 (I assume the second option)?

I think postgresql.org could do a much better job at documentation. A simple search for "postgresql psql" returns result that points to 9.3 version which is unsuported. Also their current version does not redirect to 12 - in the url - but rather uses separate url. They also don't use any header tab to point to canonical version of documentation.

I propose the following:

• for both channels (stable / unstable) I would create a redirect to latest minor version, eg: /manual/nix/stable -> /manual/nix/1.3
• to the version/channel switcher box I would list both Channels (stable/unstable) and Versions (19.09/20.03/20.09/...)
• wherever we are pointing to documentation we should be pointing to "stable" channel
• the canonical tag will be still pointing to "stable" channel

Sound ok?

Also should we might start keeping older versions of documentation around (like postgresql)?

🚀 Deployed on https://5f44e16f080d404674896c42--nixos-homepage.netlify.app

Another question that raised in my head since few days: Are we going to always keep documentation online, especially the versioned one?

What will happen is that with every release we will break what google has indexed. eg. All documentation under /manual/nixos/20.03 will be removed once 20.09 is released.

For sake of moving forward with this I would suggest we only introduce channels (stable/unstable).
It would be extremely nice to have all of the versions of documentation always there, but we might need to have another discussion regarding this especially once all the work around documentation format and tooling is decided.

/cc @edolstra

🚀 Deployed on https://5f48cb40986584dd7765df7f--nixos-homepage.netlify.app

For sake of moving forward with this I would suggest we only introduce channels (stable/unstable).
It would be extremely nice to have all of the versions of documentation always there, but we might need to have another discussion regarding this especially once all the work around documentation format and tooling is decided.

yes, we keep all the packages, so why would we not keep the manual. having stable and unstable is already a huge step 🎉