I am talking from experience here. Some of the documentation is out of date, some is meant for Channel NixOS installs and not so appropriate for Flake-based installs.
Most of the fixes for my issues I find across NixOS discourse forum posts, or in the subreddit of the other platform. The Wiki/official documentation is not enough.
I’m glad you switched to NixOS (welcome!) but this is gap in documentation is something that will become more apparent over time. The NixOS official wiki ironically often links to Arch wiki to explain certain concepts further.




Uh… is the NixOS documentation “one of the best around” or have you never checked it? It really can’t be both.
Understand, I’m not trying to criticize NixOS. I use NixOS exclusively and it’s my daily driver. But the documentation really isn’t all there, and it’s not centralized. The best solutions you find across forums, blog posts, random wikis, and by checking other people’s configs like you said.
But yes, the fact you can test things without fear of breaking your system allows you to make hundreds of mistakes stress-free. That’s one of the best features about NixOS.