When contributing to this repository, please make sure to read through these guidelines. Note that no matter how you contribute, your participation is governed by our Code of Conduct.
Please use the GitHub issue tracker to submit bug reports and feature requests.
- Check the open issues to ensure you are reporting a new issue
Once you're done making the changes, you can now open a pull request (PR). Go to the forked repository in GitHub and select your feature branch. Click the 'Pull Request' button and fill out the form.
While naming your Pull Request, make sure to read the following commit message guidelines.
We use Interactive Commitizen CLI (czg) to generate standardized commit messages following the Conventional Commits specification.
<type>(<scope>): <short summary>
│ │ │
│ │ └─⫸ Summary in present tense. Not capitalized. No period at the end.
│ │
│ └─⫸ Commit Scope: workspace|docs
│
└─⫸ Commit Type: feat|fix|refactor|chore|revert
The <type>
and <summary>
fields are mandatory, the (<scope>)
field is optional.
Click here to see a more detailed description on the commit message format.
Must be one of the following:
- feat: A new feature
- fix: A bug fix
- refactor: A code change that neither fixes a bug nor adds a feature
- chore: Other changes that don't modify src or test files
- revert: Reverts a previous commit
The scope should be the name of the npm package affected (as perceived by the person reading the changelog generated from commit messages).
The following is the list of supported scopes:
workspace
docs
Use the summary field to provide a succinct description of the change:
- use the imperative, present tense:
change
notchanged
norchanges
- don't capitalize first letter
- no dot (.) at the end
Just as in the summary, use the imperative, present tense: “change” not “changed” nor “changes”. The body should include the motivation for the change and contrast this with previous behavior.
The footer should contain any information about Breaking Changes and is also the place to reference GitHub issues that this commit Closes.
Breaking Changes should start with the word BREAKING CHANGE:
with a space or two newlines. The rest of the commit message is then used for this.
A detailed explanation of Conventional Commits messages can be found at Conventional Commits examples.