Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

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.



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: