update docs with JSON schema

[gwenchee]

This issue can be closed after I complete #56 and import the corresponding JSON schema into the docs