Move to docs.nixos.org
Nobody has claimed this yet.
- Dominant language
- Nix
- Stars
- 4k
- Forks
- 339
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 7
Description
There's currently two official domains for the Nix platform:
- nixos.org: Pretty much everything is under here. Main website, Hydra, cache, status page, search, reference documentation
- nix.dev: Tutorials and guides, since https://github.com/NixOS/nix.dev/pull/764 also the Nix reference manual
It's not great to have two domains because the default assumption is that different domains are different entities, so people don't expect both to be official.
My proposal to resolve this is by moving nix.dev to docs.nixos.org.
Since this only really involves the documentation team and is not that substantial of a change, we should be able to proceed with this plan by reaching consensus among the members, without the need for an RFC. Of course anybody is welcome to step in with arguments for/against this.
Related are:
- A fairly orthogonal RFC draft to move everything to nix.dev instead: https://github.com/nix-rfc-canonical-domain/rfcs/blob/canonical-domain/rfcs/1000-canonical-domain.md. See the issues for discussions, in particular:
- https://github.com/NixOS/org/issues/80
- https://github.com/NixOS/nix.dev/issues/290
- https://github.com/NixOS/foundation/issues/113#issuecomment-1906722707
Ping @NixOS/documentation-team, please indicate your opinion on this issue
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No source files or tests are named. Start by reading this issue and the linked RFC and related discussions, then identify the documentation sites and migration work involved; the issue is done only once the documentation team's domain decision and resulting move are complete.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100