centralize collection of resources and recommendations
there are multiple locations which overlap in serving the overview function for different topics:
- https://nixos.org/learn.html
- https://nixos.org/community/
- https://nix.dev/recommended-reading
- https://nixos.wiki/wiki/Resources
proposal to increase centralization and ease curation:
- determine a location for collections of resources on each topic
- remove redundant information from the other locations
- link appropriately
examples:
- learning Nix
- "learning Nix" is actually learning/understanding multiple things
- how to navigate the ecosystem
-
nixcommands - Nix language syntax and semantics
-
builtinsandpkgs.lib -
nixpkgspatterns and idioms - language-specific patterns and tooling
- NixOS modules
- software development with Nix
- contributing to the ecosystem
- ...
- as we decided to make nix.dev the official Nix learning resource, curating additional learning resources should be managed there
- suggestion: only link to nix.dev from here
- communication channels
- community communication channels are presented on nixos.org
- as we decided and formalized for Summer of Nix 2022 and Nix documentation team the NixOS Wiki should be the staging area for edge cases and auxiliary information
- NixOS Wiki: Get In Touch links to nixos.org and additionally lists unofficial channels
- suggestion: only link to nixos.org from here
related: https://github.com/NixOS/nixpkgs/issues/121403 (Bring the Haskell documentation back into nixpkgs)
I haven't kept up super well with Discourse (lot of stuff with work recently), so I can certainly agree with some of those consolidations.
As I mentioned in #123, an awesome list is to provide projects that are truly "awesome". As such, providing an exhaustive list of resources is specifically beyond its purview. If coordinated to move these non-project items to the Wiki (where they probably should only have been in the first place) or even to the nixos org site, it might make more sense to remove all of these items entirely, leaving only a link to a more exhaustive resource like https://nixos.org/.
Closing, as this is beyond the scope of the project, and seems to be documented elsewhere now.