added some intro, made the text a little less JSON-only
minor edit
made schema a bit more compact