You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@solr.apache.org by "ASF subversion and git services (Jira)" <ji...@apache.org> on 2023/03/13 19:08:00 UTC
[jira] [Commented] (SOLR-16346) Generate OpenAPI spec for v2 APIs
[ https://issues.apache.org/jira/browse/SOLR-16346?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17699799#comment-17699799 ]
ASF subversion and git services commented on SOLR-16346:
--------------------------------------------------------
Commit 637f3705e87510dfb3ef2bca8625a184982bb1e7 in solr's branch refs/heads/main from Houston Putman
[ https://gitbox.apache.org/repos/asf?p=solr.git;h=637f3705e87 ]
Fix version parsing in dev-tools
Relates to a change created by SOLR-16346
> Generate OpenAPI spec for v2 APIs
> ---------------------------------
>
> Key: SOLR-16346
> URL: https://issues.apache.org/jira/browse/SOLR-16346
> Project: Solr
> Issue Type: Improvement
> Components: v2 API
> Affects Versions: main (10.0)
> Reporter: Jason Gerlowski
> Assignee: Jason Gerlowski
> Priority: Major
> Fix For: main (10.0), 9.2
>
> Time Spent: 2h 50m
> 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-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org