The "official" JSON should be enhanced to cover a few of the pain points.