exceptionfactory opened a new pull request #5715: URL: https://github.com/apache/nifi/pull/5715
#### Description of PR NIFI-9630 Migrates the NiFi Registry REST API documentation generation from `swagger2markup-maven-plugin` to `swagger-codegen-maven-plugin`. The [Swagger2Markup](https://github.com/Swagger2Markup/swagger2markup) project is no longer maintained and the last release of the Maven plugin was in 2018. These changes also remove the need for the `asciidoctor-maven-plugin`, which converts the documentation to HTML. Although the styling is somewhat different, the generated HTML documentation contains the same information and the `swagger-codegen-maven-plugin` is actively maintained. Additional changes include removing the templates associated with the generation of other unused REST API documentation for NiFi Registry. This migration also supports removing dependence on the read-only JCenter repository since Maven Central does not contain all of the transitive dependencies that Swagger2Markup requires. In order to streamline the review of the contribution we ask you to ensure the following steps have been taken: ### For all changes: - [X] Is there a JIRA ticket associated with this PR? Is it referenced in the commit message? - [X] Does your PR title start with **NIFI-XXXX** where XXXX is the JIRA number you are trying to resolve? Pay particular attention to the hyphen "-" character. - [X] Has your PR been rebased against the latest commit within the target branch (typically `main`)? - [X] Is your initial contribution a single, squashed commit? _Additional commits in response to PR reviewer feedback should be made on this branch and pushed to allow change tracking. Do not `squash` or use `--force` when pushing to allow for clean monitoring of changes._ ### For code changes: - [ ] Have you ensured that the full suite of tests is executed via `mvn -Pcontrib-check clean install` at the root `nifi` folder? - [ ] Have you written or updated unit tests to verify your changes? - [ ] Have you verified that the full build is successful on JDK 8? - [ ] Have you verified that the full build is successful on JDK 11? - [ ] If adding new dependencies to the code, are these dependencies licensed in a way that is compatible for inclusion under [ASF 2.0](http://www.apache.org/legal/resolved.html#category-a)? - [ ] If applicable, have you updated the `LICENSE` file, including the main `LICENSE` file under `nifi-assembly`? - [ ] If applicable, have you updated the `NOTICE` file, including the main `NOTICE` file found under `nifi-assembly`? - [ ] If adding new Properties, have you added `.displayName` in addition to .name (programmatic access) for each of the new properties? ### For documentation related changes: - [X] Have you ensured that format looks appropriate for the output in which it is rendered? ### Note: Please ensure that once the PR is submitted, you check GitHub Actions CI for build issues and submit an update to your PR as soon as possible. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@nifi.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org