Release-Checklist.md

 ## Before Release
 
+- Add a quick announcement on the Gitter channel (one day before)
+
+- Update dependencies if needed (swagger-core, swagger-parser versions...). (e.g. [#4889](https://github.com/swagger-api/swagger-codegen/pull/4889)). If you change this, please performs some tests to ensure that nothing is broken after the update.
 - Review [milestones](https://github.com/openapitools/openapi-generator/milestones) to ensure there are no outstanding issues/PRs that need to be urgently addressed before the release.
-- Create the next milestone (e.g. 3.0.3 if the current version if 3.0.2-SNAPSHOT)
-- Update **open** PRs, issues of the current milestone (e.g. 3.0.2) to the next milestone (3.0.3)
-- update dependencies if needed (core, parser versions...) (e.g. [#4889](https://github.com/swagger-api/swagger-codegen/pull/4889)), if needed. For issues, here are the steps:
-  - Go to the [issue tracker](https://github.com/OpenAPITools/openapi-generator/issues)
-  - Click on the drop-down menu "Milestones" and select `3.0.2` (current milestone)
-  - After the page loading completes (which show all issues for the milestone `3.0.2`), click on the checkbox next to the issue counter (right below `Clear current search query, filters, and sorts`) to select all issues in the current page
-  - Click again 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
-  - (the same procedure can be applied to updating the PR's milestone)
+
+- Create the next milestone (e.g. 3.0.3 if the current version is 3.0.2-SNAPSHOT)
+- Update **open** PRs & issues of the current milestone (e.g. 3.0.2) to the next milestone (3.0.3), here are the steps:
+  - Go to the [Milestones list](https://github.com/OpenAPITools/openapi-generator/milestones)
+  - Select the current milestone (`3.0.2`)
+  - 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.
 
-- Add a quick announcement on the Gitter channel (one day before)
-
 ## Release
 
 - merge the "prepare release" PR