Arguably anything in the docs that say "Run nix-env ..." is wrong, or at least not the flakes way of doing things. It would be much more clear if the docs just

Arguably anything in the docs that say "Run nix-env ..." is wrong, or at least not the flakes way of doing things. It would be much more clear if the docs just came out and said "nix-env is deprecated, move to flakes, here's where to read the flakes way to do things".