Yes, comments in `haskell-packages.nix` won't be lost; that's an alternative. 

Personally, I feel that a good commit message is sufficient, though. If I want to know why a package has its test disabled, my first attempt to find out would be to consult `git log` or `git blame`.