- [x] create json schema - [ ] validate examples in unit tests against schema - [x] generate docs from json schema