Improve JSON Schema

[marcofavorito]

Is your feature request related to a problem? Please describe.

Currently, we don't use the "description" field for properties.
E.g. look at an example here.

Also, we could use allOf to model the hierarchy of schemas. E.g. we can define a package schema and have the other schemas like protocol, connection etc. extending it.

Describe the solution you'd like
Use them for all the properties in the JSON schema.

Describe alternatives you've considered

Additional context