Your comments

From build 2020 Sublime uses Sparkle. Great!
The current icon is *really* nondescriptive. It doesn't need to be very fancy, but something else than a black square with a white border would at least make it stand out a little in a dock, so i don't need to hunt around to find it :)
Until there is a nice GUI for setting preferences i guess comments in JSON are badly needed to explain all the different settings. It's not valid, but then again maybe it isn't JSON but a Javascript object (which does allows comments) ;)