Release strategy, conventions, preparation and execution

Release strategy

Devicon does not follow a strict release plan. A new release is depended on current amount of contributions, required bugfixes/patches and will be discussed by the team of maintainers.

Generally speaking: A new release will be published when new icons are added or a bug was fixed. When it's predictable that multiple icons are added in a foreseeable amount of time they are usually wrapped together.

Conventions

The version naming follows the rules of Semantic Versioning. Given a version number MAJOR.MINOR.PATCH, increment the:

• MAJOR version when you make incompatible API changes,
• MINOR version when you add functionality (like a new icon) in a backwards compatible manner, and
• PATCH version when you make backwards compatible bug fixes.

Execution

1. Define the next release version number based on the conventions
2. Checkout develop as draft-release branch.

   git checkout develop
   git checkout -b draft-release

3. Bump the package version using npm version vMAJOR.MINOR.PATCH -m "bump npm version to vMAJOR.MINOR.PATCH" (see #487)
4. Push the branch draft-release
5. Manually trigger the workflow build_icons.yml (which has a workflow_dispatch event trigger) and select the branch draft-release as target branch. This will build a font version of all icons using icomoon and automatically creates a pull request to merge the build result back into draft-release
6. Review, approve and merge the auto-created pull request created by the action of the step above
7. Create a pull request from draft-release towards develop. Mention the release number in the pull request title (like "Build preparation for release vMAJOR.MINOR.PATCH").
   • Check the build-bot's PR message in the last step. There should be a section where it displays the features that have been added to the release. You can copy the markdown there and put it in the description as a CODE BLOCK. This will prevent GitHub from tagging everyone involved for now.
8. Wait for review and approval of the pull request (you can perform a squash-merge)
9. Once merged into develop create a pull request with BASE master and HEAD develop.
   • Copy the build-bot's PR message in the last step to the description as MARKDOWN text. This will tag all contributors and thanks them for their help.
10. Since it was already approved in the 'develop' stage a maintainer is allowed to merge it (DON'T perform a squash-merge).
11. Create a new release using the format "Release vMAJOR.MINOR.PATCH" as tag and release title. Use the earlier created description as description of the release.
12. Publishing the release will trigger the npm_publish.yml workflow which will execute a npm publish leading to a updated npm package (vMAJOR.MINOR.PATCH).
13. If the icons fail to appear on the website, you may clear the CDN cache by clicking this link.