News for hackers. Stuff that matters.
Re:How Nix and NixOS get so close to perfect by infogulch on Sunday April 24, 2022 @01:45PM (#31146350)
Maybe nix needs to organize docs around the users intention:

https://documentation.divio.com/

The big idea is that it separates types of documentation by its usefulness to a particular user that is approaching the docs with a clear goal. Here the goals are loosely organized along two 'axes': working-studying and theoretical-practical. Personally I think the model is missing a user-developer axis (especially for a developer tool like nix), but overall it's a great lens to view any documentation project through.

There are no comments on this comment yet.