Subject: [Jmap] JSON Schema

From: Lukas Eipert <[email-masked]>
Date: Fri, 14 Jul 2017 20:50:03 +0200

Hi all,
I had a quick glance over the jmap specification [1] in the github repo. In my opinion it would be useful to convert the markdown descriptions to json schema [2]. This should make it easier

1. to validate the spec itself
2. to validate servers/clients against the spec
3. generate documentation [3]

I could spend some of my time helping you with a migration to json schema and setup of a json-schema->documentation pipeline starting end of July iff you are interested.

Otherwise the project looks great and I wish the best of luck that xkcd 927 [4] may not be the future for this project ;)

[1]: https://github.com/jmapio/jmap/tree/master/spec/mail <https://github.com/jmapio/jmap/tree/master/spec/mail>
[2]: http://json-schema.org/ <http://json-schema.org/>
[3]: https://github.com/cloudflare/doca <https://github.com/cloudflare/doca>
[4]: https://xkcd.com/927/ <https://xkcd.com/927/>