But yaml + comments (+ commented out optional settings) is basically the best semi self documenting config format in existence.
Jason doesn't allow comments, Xml is too verbose and lacks a zero-depth later (aka a properties file), properties files can't do arrays or hierarchies or complex inline stuff, and aren't well standardized, and TOML is ugly.
I'm not some yaml zealot, it's not a perfect format, but ... I've seen nothing better.