[jira] [Created] (SOLR-16880) Make OpenAPI spec a release artifact

["Jason Gerlowski (Jira)" <ji...@apache.org>]

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: issues-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org