Nix problem/goal -> pattern flowcharts?

I was skimming the HN thread for Christine Dodrill’s latest Nix post last night ( and had a thought while reflecting on some of the difficulties described (which I relate to…):

I wondered if new users would have an easier time finding their sea legs if they could reference a living flowchart (like a differential diagnosis chart?) that maps common problems/goals(/frustrations?) to up-to-date best-practice patterns/tools/options/features across the ecosystem.

  • It’s secondary, and I’m not sure how to do it intuitively, but there might be additional value in keeping previous-best-practices discoverable (which might help update old patterns, or interpret old posts/answers/repos)?

  • I don’t imagine this as an FAQ replacement (because its scope should be well defined), but it would certainly fold in how-do-I-X kinds of questions.

  • If the graph grew dense enough, the reverse might also be helpful: start with a NOUN in the ecosystem, and see the problems/goals/frustrations it addresses.


I believe this would be a really great idea.

I jumped into NixOS quite recently, and it was really hard at the beginning, I really struggled with how things are working, how they are put together.
When it came to some basic developer stuff like “How do I setup back my ruby environment” I had the feeling Nix could helped me create a reproducible development environment without using rbenv, etc…, but I could not find how to leverage it. Fortunately, I’ve been helped throughout my journey by people on this discourse, without their help I could have give up.

After a few months (3, in fact) I started understanding how it works (I’m quite a slow learner), made some PR (and managed to make a mistake while doing this by the way). And its only after all this time that I can say I started to understand on how all the things are put together.

There is still a lot of things I didn’t took time to understand correctly (why are overlays better than package overrides, what are Flakes and how can I leverage them, what are the concrete use-cases of both etc…).

If we could lower the learning-curve steep, even just a bit, it would totally worth the effort. Even if understanding more of Nix/NixOS is always rewarding, making that “reward” a bit more accessible could be a huge plus for opening this technology to a bigger audience.

I know people that want to try NixOS, but that are afraid with the complexity. Using a system that is fundamentally different on some basic aspects can be a bit frustrating when you have “muscle memory” on how to setup your favorite development environment for your favorite framework on imperative systems.

TL;DR : The idea behind the living flowchart is really great.

I would love to see and help you build such living flowchart.