Skip to content

Latest commit

 

History

History
50 lines (35 loc) · 3.04 KB

CONTRIBUTING.md

File metadata and controls

50 lines (35 loc) · 3.04 KB

Contributing

Your contributions to this project are very welcome, be it a new feature, a bugfix, better documentation, or something else. Feel free to create a pull request, but please adhere to the format specified below. This strict format is required so semantic-release can automatically handle semantic versioning and update changelogs. An automated check ensures that pull requests have a matching title:

image

If this check fails, simply edit the title of the pull request. There is no need to close it and to create a new one.

Format of a Pull Request

Title

The title must follow the Conventional Commits convention. It must consist of (in this order)

  • a type (see below),
  • an optional scope in parentheses (see below),
  • an exclamation mark if and only if it is a breaking change,
  • a colon and a summary of the purpose of the pull request.

Types

All types from Commitizen are allowed. Pick the one that fits best:

Type Meaning
feat New feature
fix Bug fix
docs Documentation only changes
test Adding missing tests or correcting existing tests
perf Changes that improve performance
refactor Changes that neither fix a bug nor add a feature
style Changes to code style (whitespace, formatting, missing semicolons, etc)
build Changes that affect the build system or external dependencies (e.g. npm)
ci Changes to CI configuration files and scripts (e.g. GitHub Actions)
revert Reverting a previous commit
chore Other changes that don't modify src or test files

Scopes

If you want to specify exactly which part of the code is affected by your pull request, you can add a scope in parentheses after the type. No specific rule applies for the choice of the scope, just skim the commit history to see if a fitting scope has been used before.

Examples

  • feat(listView): sort entries alphabetically
  • docs: write contributing guide
  • refactor!: drop support for older browsers (the exclamation mark denotes a breaking change)

Description

Use the provided template. It should be suggested automatically.