Issues with the 2019-11-17 specification

[Rami-Sabbagh]

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

[Rami-Sabbagh]

Found another issue:

• There are some structures with fullDescription instead of longDescription

[Rami-Sabbagh]

• The multiple usage variant of method structure has both note and notes fields

[Rami-Sabbagh]

• The returns of a method need a literal boolean field for indicating that

[Rami-Sabbagh]

It turns out the the fullDescription is named that way because it'll replace the shortDescription when displayed

• That has to be cleared out in the specification