[jboss-jira] [JBoss JIRA] (WFLY-12998) MicroProfile OpenAPI: validate generated OpenAPI document

[Fabio Burzigotti (Jira)]

     [ https://issues.redhat.com/browse/WFLY-12998?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Fabio Burzigotti moved WFWIP-292 to WFLY-12998:
-----------------------------------------------

        Project: WildFly  (was: WildFly WIP)
            Key: WFLY-12998  (was: WFWIP-292)
    Component/s: MP OpenAPI
                     (was: MP OpenAPI)


> MicroProfile OpenAPI: validate generated OpenAPI document  
> -----------------------------------------------------------
>
>                 Key: WFLY-12998
>                 URL: https://issues.redhat.com/browse/WFLY-12998
>             Project: WildFly
>          Issue Type: Enhancement
>          Components: MP OpenAPI
>            Reporter: Fabio Burzigotti
>            Assignee: Paul Ferraro
>            Priority: Major
>
> Currently no validation is provided for generated document and actually the spec is not requesting for vendors to do that [1] but it would definitely be a key improvement for customers and users in general to know that the generated document is checked and appropriate action is taken in case content is not valid (e.g.: log WARN messages etc.).
> Online Swagger Editor [2] was used to verify that non valid content was generated.
> Also it should be evaluated whether to mention this behavior in community or product docs.
> [1]
> https://download.eclipse.org/microprofile/microprofile-open-api-1.1.2/microprofile-openapi-spec.html#_validation
> [2]
> https://editor.swagger.io/  



--
This message was sent by Atlassian Jira
(v7.13.8#713008)