I've read the specification today, after a while of no updates, and I've noticed the following issues for now:

• The simple types miss the "thread" type, which is the coroutines.
• There's a miss-spelling at line 12 (descripts -> describes)
• There are some structures with fullDescription instead of longDescription, it has to be clearified that the fullDescription is meant to replace the shortDescription when the documentation is expanded.
• The multiple usage variant of method structure has both note and notes fields
• The returns of a method need a literal boolean field for indicating that