Not a comment on your post but the NixOS ecosystem in general
Probably should've used the word "dislike" instead of hate. Apologize.
As someone whose been using Nix for almost a year (not NixOS as long) I struggle that there is zero advanced write ups.
Could be because it's the same experience which is good news.
But there's a series of advanced concepts that deserve more love: custom Nix cache, distributed building, remote deployments , NixOps, writing eloquent derivations, secret management (please!), how to sanely use vim_configurable etc...
I spent a long time documenting the Maven (Java) documentation and recently had it approved.
I'll make a follow-up in more time (some months) and go in more details!