Introduce OpenAPI generation of REST API documentation

[michael-valdron]

Which area this feature is related to?

/area documentation

Which area is this documentation change is related to?

/area registry

Issue details

With the introduction of the OpenAPI 3 specification in #972 gives a centralized definition for the REST endpoints and connected schema types. With this, it would add to our ability to reduce the work on both the source and the documentation for the RESTful API to generate the definitions within both.

For the REST API documentation, we need:

1. A mechanism to generate doc pages which will replace the current documentation for the RESTful APIs
2. A mechanism to host the doc pages for anyone to view
   • Ideally a way to make it simple for RESTful API consumers to reference when they need it

[github-actions]

This issue is stale because it has been open for 90 days with no activity. Remove stale label or comment or this will be closed in 60 days.

[michael-valdron]

This issue is stale because it has been open for 90 days with no activity. Remove stale label or comment or this will be closed in 60 days.

Should be planned at some point.

[github-actions]

This issue is stale because it has been open for 90 days with no activity. Remove stale label or comment or this will be closed in 120 days.