Jason Gerlowski created SOLR-16880:
--------------------------------------
Summary: Make OpenAPI spec a release artifact
Key: SOLR-16880
URL: https://issues.apache.org/jira/browse/SOLR-16880
Project: Solr
Issue Type: Improvement
Security Level: Public (Default Security Level. Issues are Public)
Components: v2 API
Reporter: Jason Gerlowski
SOLR-16346 added OpenAPI spec generation to Solr - allowing us to produce a
detailed description of our v2 APIs (or at least - those APIs implemented using
JAX-RS).
These spec files have a lot of potential uses - from generating documentation,
to API clients, to web UIs. These have a lot of promise, but it will take the
community time to implement and adopt some of them.
We should make the OpenAPI spec available as a release artifact, so that users
can more easily take advantage of it. Having it published on each release will
also allow us to compare specs across versions, as a way to detect backcompat
breaks before changes go out the door.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
