Document Presto's endpoints using OpenAPI

[tdcmeehan]

OpenAPI is a ubiquitous standard for documenting HTTP based APIs. Most of Presto's endpoints are RESTful, and therefore would be amenable to being documented by a standard such as OpenAPI. There are several benefits to adding this documentation:

1. By encoding the endpoints using a standard, documentation for these endpoints can be automatically generated, which will help developers extend and interact with Presto.
2. We can generate client code using OpenAPI standards, which can help users of Presto extend it.
3. We can easily generate server mocks for external components.

Expected Behavior or Use Case

We have a new folder for documentation of Presto API's based off of OpenAPI.

Presto Component, Service, or Connector

Core

Possible Implementation

N/A

Example Screenshots (if appropriate):

N/A

Context

https://learn.openapis.org/