Writing OpenAPI and JSON LD descriptors

Services should be REST web services described using OpenAPI 3.0 (Swagger) descriptors, annotation with ontological definitions defined using JSON-LD.

• Open API 3.0 Specification
• JSON-LD
• The BridgeDb Notebook

TODO - provide links and guidance to how to annotate your services.