[ https://issues.apache.org/jira/browse/SOLR-16346?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17609230#comment-17609230 ]
ASF subversion and git services commented on SOLR-16346: -------------------------------------------------------- Commit bf7b86ac23a09acc147092d330cc78d651253409 in solr's branch refs/heads/main from Jason Gerlowski [ https://gitbox.apache.org/repos/asf?p=solr.git;h=bf7b86ac23a ] SOLR-16346: Fix intermittent 'check' error (#1043) A previous commit for SOLR-16346 introduced a usedUndeclared 'check' error that only showed up in some limited environments. This commit fixes that check error by declaring the correct dep: switching 'swagger-core' out for 'swagger-annotations'. > Generate (and use) OpenAPI spec for v2 APIs > ------------------------------------------- > > Key: SOLR-16346 > URL: https://issues.apache.org/jira/browse/SOLR-16346 > Project: Solr > Issue Type: Improvement > Security Level: Public(Default Security Level. Issues are Public) > Components: v2 API > Affects Versions: main (10.0) > Reporter: Jason Gerlowski > Assignee: Jason Gerlowski > Priority: Major > Time Spent: 2h 40m > Remaining Estimate: 0h > > An integration with [OpenAPI|https://www.openapis.org/] and its tooling has a > lot to offer Solr. Once generated, an OpenAPI specification can be used to: > * [generate clients|https://github.com/OpenAPITools/openapi-generator] for > multiple programming languages > * power a web UI to document and help users craft API calls (e.g. > [redoc|https://github.com/Redocly/redoc] > * [detect breaking API changes|https://github.com/Azure/openapi-diff] across > releases. > Of course, these benefits are only useful if we take pains to document our > API inputs and outputs (probably with annotations that live directly in our > Java code). But I think there's enough upside to be worth that trouble. > This ticket aims to cover integrating OpenAPI into our gradle build, so that > a single task can be used to generate an OpenAPI spec. (It might also make > sense to use this ticket to cover generating client bindings for one or more > languages.) -- This message was sent by Atlassian Jira (v8.20.10#820010) --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org For additional commands, e-mail: issues-h...@solr.apache.org