How long did you spend trying to learn Nix? I am trying to learn Nix as well because when I see it working it looks very clear and organized.

NixOS seems like it is from the future in my opinion. I agree the docs are outdated a bit. I had to go on IRC to #nixos to find out nix-shell is now nix shell. I submitted a pull request to the Nix Pills for that.