[jira] [Updated] (NIFI-9630) Migrate NiFi Registry to swagger-codegen-maven-plugin
[
https://issues.apache.org/jira/browse/NIFI-9630?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Bryan Bende updated NIFI-9630:
--
Fix Version/s: 1.16.0
Resolution: Fixed
Status: Resolved (was: Patch Available)
> Migrate NiFi Registry to swagger-codegen-maven-plugin
> -
>
> Key: NIFI-9630
> URL: https://issues.apache.org/jira/browse/NIFI-9630
> Project: Apache NiFi
> Issue Type: Improvement
> Components: NiFi Registry
>Reporter: David Handermann
>Assignee: David Handermann
>Priority: Minor
> Fix For: 1.16.0
>
> Time Spent: 20m
> Remaining Estimate: 0h
>
> NiFi Registry REST API documentation uses a combination of the
> {{swagger2markup-maven-plugin}} and the {{asciidoctor-maven-plugin}} to
> generate the REST API documentation HTML for embedding and publication. The
> [Swagger2Markup|https://github.com/Swagger2Markup/swagger2markup] project is
> no longer maintained, and the last version was released in 2018. In addition,
> the transitive dependencies for Swagger2Markup are no available in Maven
> Central, but can be found in the read-only JCenter repository.
> The [Swagger
> Codegen|https://swagger.io/docs/open-source-tools/swagger-codegen/] library,
> and associated Maven plugin, support generating static HTML documentation
> from Swagger definitions. The library and Maven plugin are actively
> maintained and provides a replacement for the current REST API documentation
> approach in NiFi Registry. Although the styling is different than the current
> approach, the generated HTML contains the same information.
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
[jira] [Updated] (NIFI-9630) Migrate NiFi Registry to swagger-codegen-maven-plugin
[
https://issues.apache.org/jira/browse/NIFI-9630?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
David Handermann updated NIFI-9630:
---
Status: Patch Available (was: Open)
> Migrate NiFi Registry to swagger-codegen-maven-plugin
> -
>
> Key: NIFI-9630
> URL: https://issues.apache.org/jira/browse/NIFI-9630
> Project: Apache NiFi
> Issue Type: Improvement
> Components: NiFi Registry
>Reporter: David Handermann
>Assignee: David Handermann
>Priority: Minor
> Time Spent: 10m
> Remaining Estimate: 0h
>
> NiFi Registry REST API documentation uses a combination of the
> {{swagger2markup-maven-plugin}} and the {{asciidoctor-maven-plugin}} to
> generate the REST API documentation HTML for embedding and publication. The
> [Swagger2Markup|https://github.com/Swagger2Markup/swagger2markup] project is
> no longer maintained, and the last version was released in 2018. In addition,
> the transitive dependencies for Swagger2Markup are no available in Maven
> Central, but can be found in the read-only JCenter repository.
> The [Swagger
> Codegen|https://swagger.io/docs/open-source-tools/swagger-codegen/] library,
> and associated Maven plugin, support generating static HTML documentation
> from Swagger definitions. The library and Maven plugin are actively
> maintained and provides a replacement for the current REST API documentation
> approach in NiFi Registry. Although the styling is different than the current
> approach, the generated HTML contains the same information.
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
