Skip to content

Latest commit

 

History

History
40 lines (28 loc) · 2.38 KB

CONTRIBUTING.md

File metadata and controls

40 lines (28 loc) · 2.38 KB
Raw

CONTRIBUTING

Publishing a New Release

The process to release to npm should be started when all pull requests intended for publishing have been merged and the software has been fully tested for publication. You can release either using GitHub Actions or locally.

Versioning Guidelines

  • patch: for non-breaking changes/bugfixes and small updates.
  • minor: for some new features, bug fixes, and other non-breaking changes.
  • major: for breaking changes.

GitHub Actions

This is the preferred method for pushing out the latest release. The workflow runs a bunch of validations, generates a build, bump versions + tags, pushes out to npm, and bumps to the next dev version.

  1. Initiate the release process here.
  2. On the right-hand side, select "Run Workflow".
  3. Choose your preferred version bump.
  4. Click "Run Workflow".
  5. Wait for a pull request to appear. The pull request will update the version number and shall be assigned to you.
  6. When ready, merge the pull request. This will lead to a new version to be published on npmjs.com.
  7. Another pull request will be created to bump to a development version, also assigned to you. Merge it to finish the process.
NPM access token

Note: Publishing via the GitHub Action requires that the NPM_TOKEN be set correctly in GitHub Actions secrets. This should be an npm token generated for a bot user (wpvip-bot).

Local

If GitHub Actions is down or not working for some reason or you need to push a release for a previous version (e.g. security release), you can still publish a new release.

  1. Check out the branch or commit you want to release using git.
  2. Run npm run prepare to generate the build.
  3. Create a new branch for the release: git checkout -b release/vX.Y.Z -- remember to update the version number in the branch name.
  4. Runnpm version <type> to bump the version prior to publishing (see versioning types above).
  5. Commit the changes and create a pull request, then merge it in GitHub.
  6. Runnpm publish.
  7. Create a new release in Github. Use the built-in "Generate Release Notes" to get release notes. Tag the version.
  8. Observe that the package has been released on GitHub and npmjs.com.