.github/FUNDING.yml

@@ -0,0 +1 @@
+open_collective: springdoc-openapi

.github/workflows/master.yml

@@ -0,0 +1,33 @@
+name: Test CI
+on: [ push, fork ]
+
+jobs:
+  TEST_ALL:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        java: [ '11', '17' ]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - uses: actions/cache@v3
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle-
+
+      - name: 🪜 Setup java ${{ matrix.java }}
+        uses: actions/setup-java@v3
+        with:
+          java-version: ${{ matrix.java }}
+          distribution: temurin
+
+      - name: 🦞 chmod /gradlew
+        run: chmod +x ./gradlew
+
+      - name: 🔦 Test
+        run: ./gradlew test --info

.gitignore

@@ -76,8 +76,12 @@ out/
 ######################
 # Gradle
 ######################
-.gradle/
-/build/
+HELP.md
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**
+!**/src/test/**
 
 ######################
 # Package Files
@@ -126,6 +130,7 @@ Desktop.ini
 *.*~
 *~
 .merge_file*
+.java-version
 
 ######################
 # Gradle Wrapper

.run/TEST.run.xml

@@ -0,0 +1,34 @@
+<component name="ProjectRunConfigurationManager">
+	<configuration default="false" name="TEST" type="JUnit" factoryName="JUnit">
+		<module name="springdoc-openapi-gradle-plugin.test"/>
+		<shortenClasspath name="ARGS_FILE"/>
+		<useClassPathOnly/>
+		<extension name="coverage">
+			<pattern>
+				<option name="PATTERN" value="org.springdoc.openapi.gradle.plugin.*"/>
+				<option name="ENABLED" value="true"/>
+			</pattern>
+		</extension>
+		<extension name="net.ashald.envfile">
+			<option name="IS_ENABLED" value="false"/>
+			<option name="IS_SUBST" value="false"/>
+			<option name="IS_PATH_MACRO_SUPPORTED" value="false"/>
+			<option name="IS_IGNORE_MISSING_FILES" value="false"/>
+			<option name="IS_ENABLE_EXPERIMENTAL_INTEGRATIONS" value="false"/>
+			<ENTRIES>
+				<ENTRY IS_ENABLED="true" PARSER="runconfig"/>
+			</ENTRIES>
+		</extension>
+		<option name="ALTERNATIVE_JRE_PATH" value="corretto-19"/>
+		<option name="PACKAGE_NAME" value="org.springdoc.openapi.gradle.plugin"/>
+		<option name="MAIN_CLASS_NAME"
+				value="org.springdoc.openapi.gradle.plugin.OpenApiGradlePluginTest"/>
+		<option name="METHOD_NAME" value=""/>
+		<option name="TEST_OBJECT" value="class"/>
+		<option name="PARAMETERS" value=""/>
+		<option name="WORKING_DIRECTORY" value="%MODULE_WORKING_DIR%"/>
+		<method v="2">
+			<option name="Make" enabled="true"/>
+		</method>
+	</configuration>
+</component>

CHANGELOG.md

@@ -1,8 +1,10 @@
 # Changelog
+
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [UnReleased] -
+
 ## Added

CODE_OF_CONDUCT.adoc

@@ -1,38 +1,24 @@
 = Contributor Code of Conduct
 
-As contributors and maintainers of this project, and in the interest of fostering an open
-and welcoming community, we pledge to respect all people who contribute through reporting
-issues, posting feature requests, updating documentation, submitting pull requests or
-patches, and other activities.
+As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
 
-We are committed to making participation in this project a harassment-free experience for
-everyone, regardless of level of experience, gender, gender identity and expression,
-sexual orientation, disability, personal appearance, body size, race, ethnicity, age,
-religion, or nationality.
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality.
 
 Examples of unacceptable behavior by participants include:
 
 * The use of sexualized language or imagery
 * Personal attacks
 * Trolling or insulting/derogatory comments
 * Public or private harassment
-* Publishing other's private information, such as physical or electronic addresses,
-  without explicit permission
+* Publishing other's private information, such as physical or electronic addresses, without explicit permission
 * Other unethical or unprofessional conduct
 
-Project maintainers have the right and responsibility to remove, edit, or reject comments,
-commits, code, wiki edits, issues, and other contributions that are not aligned to this
-Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors
-that they deem inappropriate, threatening, offensive, or harmful.
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
 
-By adopting this Code of Conduct, project maintainers commit themselves to fairly and
-consistently applying these principles to every aspect of managing this project. Project
-maintainers who do not follow or enforce the Code of Conduct may be permanently removed
-from the project team.
-
-This Code of Conduct applies both within project spaces and in public spaces when an
-individual is representing the project or its community.
+By adopting this Code of Conduct, project maintainers commit themselves to fairly and consistently applying these principles to every aspect of managing this project.
+Project maintainers who do not follow or enforce the Code of Conduct may be permanently removed from the project team.
 
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community.
 
 This Code of Conduct is adapted from the
 https://contributor-covenant.org[Contributor Covenant], version 1.3.0, available at

CONTRIBUTING.adoc

@@ -1,110 +1,100 @@
 = Contributing to springdoc-openapi
 
-springdoc-openapi is released under the Apache 2.0 license. If you would like to contribute
-something, or simply want to hack on the code this document should help you get started.
-
-
+springdoc-openapi is released under the Apache 2.0 license.
+If you would like to contribute something, or simply want to hack on the code this document should help you get started.
 
 == Code of Conduct
-This project adheres to the Contributor Covenant link:CODE_OF_CONDUCT.adoc[code of
-conduct]. By participating, you are expected to uphold this code. 
 
+This project adheres to the Contributor Covenant link:CODE_OF_CONDUCT.adoc[code of
+conduct].
+By participating, you are expected to uphold this code.
 
 == Using GitHub Issues
-We use GitHub issues to track bugs and enhancements. If you have a general usage question
-please ask on https://stackoverflow.com[Stack Overflow]. The springdoc-openapi team and the
-broader community monitor the https://stackoverflow.com/tags/springdoc[`springdoc`]
+
+We use GitHub issues to track bugs and enhancements.
+If you have a general usage question please ask on https://stackoverflow.com[Stack Overflow].
+The springdoc-openapi team and the broader community monitor the https://stackoverflow.com/tags/springdoc[`springdoc`]
 tag.
 
-These are some basic guidelines before opening an issue. First of all you need to make sure, you don't create duplicate issues, and there no question already answred on https://stackoverflow.com/tags/springdoc.
+These are some basic guidelines before opening an issue.
+First of all you need to make sure, you don't create duplicate issues, and there no question already answred on https://stackoverflow.com/tags/springdoc.
 
 If you are starting using springdoc-openapi, we advise you to use the last available release.
 
 Then refer to the relevant documentation:
 
 1. For OpenAPI specification 3:
-   - https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md
+- https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md
 2. For swagger2-annotations:
-    - https://github.com/swagger-api/swagger-core/wiki/Swagger-2.X---Annotations
+- https://github.com/swagger-api/swagger-core/wiki/Swagger-2.X---Annotations
 3. For swagger-ui configuration:
-    - https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/configuration.md
+- https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/configuration.md
 4. For springdoc-openapi:
-    - https://springdoc.github.io/springdoc-openapi-demos/
-    - https://springdoc.github.io/springdoc-openapi-demos/faq.html
-    - https://springdoc.github.io/springdoc-openapi-demos/migrating-from-springfox.html
-
+- https://springdoc.github.io/springdoc-openapi-demos/
+- https://springdoc.github.io/springdoc-openapi-demos/faq.html
+- https://springdoc.github.io/springdoc-openapi-demos/migrating-from-springfox.html
 
-If you are reporting a bug, please help to speed up problem diagnosis by providing as
-much information as possible:
 
- - You need to describe your context (the title of an issue is not enough)
- - What version of spring-boot you are using?
- - What modules and versions of springdoc-openapi are you using? 
- - What are the actual and the expected result using OpenAPI Description (yml or json)?
- - Provide with a sample code (HelloController) or Test that reproduces the problem
+If you are reporting a bug, please help to speed up problem diagnosis by providing as much information as possible:
 
+- You need to describe your context (the title of an issue is not enough)
+- What version of spring-boot you are using?
+- What modules and versions of springdoc-openapi are you using?
+- What are the actual and the expected result using OpenAPI Description (yml or json)?
+- Provide with a sample code (HelloController) or Test that reproduces the problem
 
 == Reporting Security Vulnerabilities
-If you think you have found a security vulnerability in Spring Boot please *DO NOT*
-disclose it publicly until we've had a chance to fix it. Please don't report security
-vulnerabilities using GitHub issues, instead head over to springdoc99@gmail.com and
-learn how to disclose them responsibly.
 
+If you think you have found a security vulnerability in Spring Boot please *DO NOT*
+disclose it publicly until we've had a chance to fix it.
+Please don't report security vulnerabilities using GitHub issues, instead head over to support@springdoc.org and learn how to disclose them responsibly.
 
 == Code Conventions and Housekeeping
-None of these is essential for a pull request, but they will all help.  They can also be
-added after the original pull request but before a merge.
-
-* We use the https://github.com/spring-io/spring-javaformat/[Spring JavaFormat] project
-  to apply code formatting conventions. If you use Eclipse and you follow the '`Importing
-  into eclipse`' instructions below you should get project specific formatting
-  automatically. You can also install the
-  https://github.com/spring-io/spring-javaformat/#intellij-idea[Spring JavaFormat IntelliJ
-  Plugin]
+
+None of these is essential for a pull request, but they will all help.
+They can also be added after the original pull request but before a merge.
+
+* We use the https://github.com/spring-io/spring-javaformat/[Spring JavaFormat] project to apply code formatting conventions.
+If you use Eclipse and you follow the '`Importing into eclipse`' instructions below you should get project specific formatting automatically.
+You can also install the
+https://github.com/spring-io/spring-javaformat/#intellij-idea[Spring JavaFormat IntelliJ
+ Plugin]
 * Make sure all new `.java` files to have a simple Javadoc class comment with at least an
-  `@author` tag identifying you, and preferably at least a paragraph on what the class is
-  for.
-* Add the ASF license header comment to all new `.java` files (copy from existing files
-  in the project)
-* Add yourself as an `@author` to the `.java` files that you modify substantially (more
-  than cosmetic changes).
+`@author` tag identifying you, and preferably at least a paragraph on what the class is for.
+* Add the ASF license header comment to all new `.java` files (copy from existing files in the project)
+* Add yourself as an `@author` to the `.java` files that you modify substantially (more than cosmetic changes).
 * Add some Javadocs.
 * A few unit tests would help a lot as well -- someone has to do it.
-* If no-one else is using your branch, please rebase it against the current master (or
-  other target branch in the main project).
-* When writing a commit message please follow https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html[these conventions],
-  if you are fixing an existing issue please add `Fixes #XXXX` at the end of the commit
-  message (where `XXXX` is the issue number).
-
-
+* If no-one else is using your branch, please rebase it against the current master (or other target branch in the main project).
+* When writing a commit message please follow https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html[these conventions], if you are fixing an existing issue please add `Fixes #XXXX` at the end of the commit message (where `XXXX` is the issue number).
 
 == Working with the Code
+
 If you don't have an IDE preference we would recommend that you use IntellIJ.
 
 === Importing into IntelliJ IDEA
-If you have performed a checkout of this repository already, use "`File`" -> "`Open`" and
-then select the root `build.gradle` file to import the code.
 
-Alternatively, you can let IntellIJ IDEA checkout the code for you. Use "`File`" ->
-"`New`" -> "`Project from Version Control`" and
-`https://github.com/spring-projects/spring-boot` for the URL. Once the checkout has
-completed, a pop-up will suggest to open the project.
+If you have performed a checkout of this repository already, use "`File`" -> "`Open`" and then select the root `build.gradle` file to import the code.
 
+Alternatively, you can let IntellIJ IDEA checkout the code for you.
+Use "`File`" ->
+"`New`" -> "`Project from Version Control`" and
+`https://github.com/spring-projects/spring-boot` for the URL.
+Once the checkout has completed, a pop-up will suggest to open the project.
 
 ==== Install the Spring Formatter plugin
-If you haven't done so, install the formatter plugin so that proper formatting rules are
-applied automatically when you reformat code in the IDE.
+
+If you haven't done so, install the formatter plugin so that proper formatting rules are applied automatically when you reformat code in the IDE.
 
 * Download the latest https://search.maven.org/search?q=g:io.spring.javaformat%20AND%20a:spring-javaformat-intellij-plugin[IntelliJ IDEA plugin].
 * Select "`IntelliJ IDEA`" -> "`Preferences`".
 * Select "`Plugins`".
 * Select the wheel and "`Install Plugin from Disk...`".
 * Select the jar file you've downloaded.
 
-
 ==== Import additional code style
-The formatter does not cover all rules (such as order of imports) and an additional file
-needs to be added.
+
+The formatter does not cover all rules (such as order of imports) and an additional file needs to be added.
 
 * Select "`IntelliJ IDEA`" -> "`Preferences`".
 * Select "`Editor`" -> "`Code Style`".
@@ -115,18 +105,18 @@ needs to be added.
 
 You can use Spring Boot project specific source formatting settings.
 
-
 ===== Install the Spring Formatter plugin
+
 * Select "`Help`" -> "`Install New Software`".
-* Add `https://dl.bintray.com/spring/javaformat-eclipse/` as a site.
+* Add `https://repo.spring.io/javaformat-eclipse-update-site/` as a site.
 * Install "Spring Java Format".
 
-NOTE: The plugin is optional. Projects can be imported without the plugins, your code
-changes just won't be automatically formatted.
+NOTE: The plugin is optional.
+Projects can be imported without the plugins, your code changes just won't be automatically formatted.
 
 === Building from Source
-springdoc-openapi source can be built from the command line using https://maven.apache.org/[Maven] on
-JDK 1.8 or above.
+
+springdoc-openapi source can be built from the command line using https://maven.apache.org/[Maven] on JDK 1.8 or above.
 
 The project can be built from the root directory using the standard maven command:
 
@@ -135,10 +125,10 @@ The project can be built from the root directory using the standard maven comman
 	$ ./mvn install
 ----
 
-
 == Cloning the git repository on Windows
-Some files in the git repository may exceed the Windows maximum file path (260
-characters), depending on where you clone the repository. If you get `Filename too long`
+
+Some files in the git repository may exceed the Windows maximum file path (260 characters), depending on where you clone the repository.
+If you get `Filename too long`
 errors, set the `core.longPaths=true` git option:
 
 ```