Yes, nixpkgs is definitely missing the self-documenting part, or even the documenting part for most of it.