Skip to content

Latest commit

 

History

History
70 lines (48 loc) · 2.04 KB

CONTRIBUTING.md

File metadata and controls

70 lines (48 loc) · 2.04 KB

Contributing

General rules

  1. Before writing any code take a look at the existing issues. If none of them is about the changes you want to contribute, open up a new issue. Fixing a typo requires no issue though, just submit a Pull Request.

  2. If you're looking for an open issue to fix, check out labels help wanted and good first issue on GitHub.

  3. If you plan to work on an issue open not by you, write about your intention in the comments before you start working.

Development rules

  1. Follow the GitHub fork & pull request flow.

  2. Install babashka

  3. Make changes to the code.

  4. Make sure tests pass:

$ bb test
  1. Open a pull request, refer to the issue you solve.

  2. Make sure GitHub Checks (Actions) pass.

Release management

  1. Follow the SemVer conventions for the release number.
  2. Update the CHANGELOG.
  3. Update the README if needed.
  4. Merge the changes to the main branch.
  5. Push a version-specific tag, e.g. v2.1.9:
$ git tag v2.1.9
$ git push origin v2.1.9
  1. Push a new or over a major version tag, e.g. v2.
# Delete the old local tag
$ git tag -d v2

# Add a new local tag
$ git tag v2

# Delete the old remote tag
$ git push -d origin v2

# Push the new remote tag
$ git push origin v2
  1. Draft a new release on the GitHub. Make sure the version-specific tag and the changelog are used for the release notes. Start a discussion thread for the release. Publish links to the testing if needed (may be a good idea for release candidates).