Generate and deploy API documentation with UI

[ZoogieZork]

Description

Generate the REST API documentation from the OpenAPI spec as part of the UI build and deploy.

This switches to Redocly-CLI, which is pulled in as a dev dependency so we can keep it updated as part of our regular dependency updates. Redocly-CLI offers OpenAPI 3.1 support, extensions to make the documentation easier to read and navigate, and an extensive linter.

Note

This does not add a link to the UI to access the API documentation; we are planning on linking to it from the internal documentation for now.

Motivation and Context

• Removes the requirement to manually install an external tool (swagger-codegen) to generate the API docs.
• Adds regular linting of the spec file.

How Has This Been Tested?

Tested in non-prod environment.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation change

Checklist

• My code follows conforms to the coding standards.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All new and existing tests passed.