Thank you for the comprehensive reply.

First, there seems to be multiple different sources of nix documentation. (as shown above)

What is this groups stance on these? It seems to me that we should try to establish a single source of truth for the documentation as the first thing?

In reply to @brunbjerg:matrix.org

Thank you for the comprehensive reply.

First, there seems to be multiple different sources of nix documentation. (as shown above)

What is this groups stance on these? It seems to me that we should try to establish a single source of truth for the documentation as the first thing?

I think I will need some help to get started then.

I have only used nix for creating reproducible devShells across different repos. A friend asked which distro he should use for a server and I thought that it is a shame that I could not recommend NixOS over Ubuntu given the trouble I had myself.

I have mostly written documentation as markdown above function and class definitions and READMEs

When you talk about documentation, do mean the:

• man configuration.nix?
• the info that you can get on individual packages on search.nixos.org?
• The wikis?

In reply to @brunbjerg:matrix.org

I think I will need some help to get started then.

I have only used nix for creating reproducible devShells across different repos. A friend asked which distro he should use for a server and I thought that it is a shame that I could not recommend NixOS over Ubuntu given the trouble I had myself.

I have mostly written documentation as markdown above function and class definitions and READMEs

When you talk about documentation, do mean the:

• man configuration.nix?
• the info that you can get on individual packages on search.nixos.org?
• The wikis?

In reply to @noob_tea:matrix.org
nix.dev is supposed to be the "single source of truth"

The biggest pain point for users at the moment is getting a grasp NixOS module interfaces. Docs quality in the code is very spotty and discoverability is not great. Most importantly we almost completely lack reliable and sufficiently complete examples.

getpsyched is currently working on the infrastructure to improve some of the discoverability aspects, and I have a prototype going for managing and presenting examples, but all of that will take a while. I’m currently preparing a substantial UX effort that should help address the most obvious, which will need a fundraiser to get the resources needed for implementation.

The irritating thing is that in principle most stuff is there, and the system is incredibly powerful — most of the good bits are just surprisingly hard to find.

In reply to @johannes.kirschbauer:scs.ems.host
One of the big painpoints also the multipage rendering. getpsyched Working on that. afaik.
Other painpoint is that we have so many entry points, (nixos-, nixpkgs-, nix- manual, nix.dev)
This adds a whole new dimension, but could be solved with a smart navigation system on a single static website.

In reply to @brunbjerg:matrix.org

Hello community,

Is there a kind of roadmap for the documentation?

Or a place that is the most in need of updating?

Kind regards

In reply to @johannes.kirschbauer:scs.ems.host
One of the big painpoints also the multipage rendering. getpsyched Working on that. afaik.
Other painpoint is that we have so many entry points, (nixos-, nixpkgs-, nix- manual, nix.dev)
This adds a whole new dimension, but could be solved with a smart navigation system on a single static website.

In reply to @johannes.kirschbauer:scs.ems.host
Maybe we can raise a pot of Money for all the Framework and infra refactoring Tasks.

Yes, we can put up a funding goal on https://opencollective.com/nixos/projects/nix-documentation

Just need to define concrete, achievable deliverables.