Release-Checklist.md

@@ -13,10 +13,18 @@
   - After the page loading completes (which show all issues and PR for the milestone `3.0.2`), click on the checkbox next to the "open" counter.
   - Click on the drop-down menu "Milestones" to change the milestones of these selected issues to `3.0.3`
   - (Repeat until all issues have been updated with the new milestones -- in case of multiple pages)
-- File a PR: (e.g. [#280](https://github.com/OpenAPITools/openapi-generator/pull/280))
-  -  to remove the SNAPSHOT version (script `bin/utils/release_version_update.sh` can be used, e.g. `bin/utils/release_version_update.sh 3.0.2-SNAPSHOT 3.0.2`)
-  -  to update the OpenAPI Generator Online's Dockerfile to use the stable version. (script `bin/utils/release_version_update.sh` can be used)
-  -  to disable bin/ensure-up-to-date.sh in shippable for the time being.
+- File a PR: (e.g. [#280](https://github.com/OpenAPITools/openapi-generator/pull/280), [#588](https://github.com/OpenAPITools/openapi-generator/pull/588))
+  - Set the correct version: (script `bin/utils/release_version_update.sh` can be used, e.g. `bin/utils/release_version_update.sh 3.0.2-SNAPSHOT 3.0.2`)
+     -  to remove the SNAPSHOT version 
+     -  to update the OpenAPI Generator Online's Dockerfile to use the stable version.
+  - to disable bin/ensure-up-to-date.sh in shippable for the time being.
+  - mention the coming release in the docs (example commit [9056c1e5e3](https://github.com/OpenAPITools/openapi-generator/pull/588/commits/9056c1e5e3f8bac515e676a4d8ebed0f0d4dc85b)):
+     - update root `README.md`: (e.g. [167b2f5](https://github.com/openapitools/openapi-generator/commit/167b2f59b811ba6780976a6e6764c1edf75a30f7), [1029b69](https://github.com/openapitools/openapi-generator/commit/1029b692e5fcfc2600433a85613ba42e2646826d))
+       - Update the release table
+       - mention the last released version in Section "1.3 - Download JAR" 
+     - update OpenAPI Generator Maven Plugin README (`modules/openapi-generator-maven-plugin/README.md`): mention the last release version in the xml snippet `<version>..</version>` (e.g. [9c79297]( https://github.com/openapitools/openapi-generator/commit/9c79297d6a073790a90b6efedd32e8bebd177828))
+     - update OpenAPI Generator Gradle Plugin README (`modules/openapi-generator-gradle-plugin/README.adoc`): mention the last release version in the `dependencies` section.
+     - update the Gradle Example Plugin README (`modules/openapi-generator-gradle-plugin/samples/local-spec/README.md`): update `-PopenApiGeneratorVersion` in the `bash` snippet
 
 ## Release
 
@@ -73,12 +81,6 @@ Checking openapi-generator-cli docker ... [OK]
 * File a PR "Prepare next snapshot version":
   - update versions to next SNAPSHOT version  (e.g. [#285](https://github.com/OpenAPITools/openapi-generator/pull/285)). Script `bin/utils/release_version_update.sh` can be used. **Be careful** this script creates changes that need to be reverted.
   - re-enable bin/ensure-up-to-date and update the Petstore samples accordingly
-  - update root `README.md`: (e.g. [167b2f5](https://github.com/openapitools/openapi-generator/commit/167b2f59b811ba6780976a6e6764c1edf75a30f7), [1029b69](https://github.com/openapitools/openapi-generator/commit/1029b692e5fcfc2600433a85613ba42e2646826d))
-     - Update the release table
-     - mention the last released version in Section "1.3 - Download JAR" 
-  - update OpenAPI Generator Maven Plugin README (`modules/openapi-generator-maven-plugin/README.md`): mention the last release version in the xml snippet `<version>..</version>` (e.g. [9c79297]( https://github.com/openapitools/openapi-generator/commit/9c79297d6a073790a90b6efedd32e8bebd177828))
-  - update OpenAPI Generator Gradle Plugin README (`modules/openapi-generator-gradle-plugin/README.adoc`): mention the last release version in the `dependencies` section.
-  - update the Gradle Example Plugin README (`modules/openapi-generator-gradle-plugin/samples/local-spec/README.md`): update `-PopenApiGeneratorVersion` in the `bash` snippet
 * update Homebrew formula to use the latest version, e.g. https://github.com/Homebrew/homebrew-core/pull/29164/commits/21c808cf733d42581e1a4a096828c1996ca314e2
 * ~~update https://generator.swagger.io to run the latest version of OpenAPI Generator~~
 * close the released milestone (see [milestones](https://github.com/openapitools/openapi-generator/milestones) view)