You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Make the task exportOpenApi more flexible so the OpenAPI specification in Ascidoc format can be integrated into existing documentation in Asciidoc format (for example into the arc42 template).
The OpenAPI specification file can be provided via command line with -P openApi.specFile=some-path/to/the-spec.yaml
The location/name of the generated Asciidoc format of the OpenAPI specification can be configured. This should be optional. If not provided, create the file in ${targetDir}/OpenAPI.
Instead of providing infoEmail and infoUrl the user can configure additionalProperties. This way the export provides more flexibility.
Provide output on console where the Asciidoc file was created.
The proposed change to the configuration for the exportOpenApi would look something like
Make the task
exportOpenApi
more flexible so the OpenAPI specification in Ascidoc format can be integrated into existing documentation in Asciidoc format (for example into the arc42 template).The proposed changes are based the comment on how to integrate OpenApi specification into ar42 documentation
Describe the solution you'd like
-P openApi.specFile=some-path/to/the-spec.yaml
${targetDir}/OpenAPI
.infoEmail
andinfoUrl
the user can configureadditionalProperties
. This way the export provides more flexibility.The proposed change to the configuration for the
exportOpenApi
would look something likeDescribe alternatives you've considered
None. But I would be glad if someone would come up with something else.
Additional context
This issue will not address #1167 but we should discuss how we could configure the export of more than one OpenAPI specification.
The text was updated successfully, but these errors were encountered: