My biggest beef with NixOS is absolutely awful documentation.

You can find three different pages on the same topic and not one of them will answer your question on it

It recommends random guides that don't work, probably due to being outdated

Different pages and "recommended" guides reference completely different ways of doing the same thing so you often cannot use one to fix your issues with another without adopting different way of doing what you are doing