Skip to content

Latest commit

 

History

History
84 lines (50 loc) · 2.69 KB

CONTRIBUTING.md

File metadata and controls

84 lines (50 loc) · 2.69 KB
Raw

Contribute to stereo-web

👍🎉 Thank you for being here. It is people like you that make hoangvvo/stereo-web great and help shape a better open-source community.

What we are looking for

I welcome all contributions from the community. There are many ways to contribute:

  • 🎨 Submit PR to fix bugs, enhance/add existed/new features.
  • 🚸 Submit bug reports and feature requests.
  • 📝 Improve documentation and writing examples.

However, please avoid using the issue tracker for questions. Use the Discussion tab instead.

How to contribute

Bug reports

If you are submitting a 🐛 bug report, please:

  • Use a clear and descriptive title. Describe the behavior you observed and the expected behavior.
  • Describe the exact steps which reproduce the problem. A minimal reproduction repo is greatly appreciated.
  • Include Node version, OS, or other information that may be helpful in the troubleshooting.

Process on submitting a PR

Generally, all pull requests should have references to an issue.

If you are ✨ adding a new feature, please first create an issue for discussion.

The steps to submit a PR are:

  1. Fork this repository to your own GitHub account and then clone it to your local device.

  2. Install all dependencies and dev dependencies by yarn. Please do not use npm to respect lock file.

  3. Make changes and commit. Use the present tense and imperative mood ("Add feature" instead of "Adds feature" or "Added feature").

  4. Make sure your code is linted by running yarn lint --fix.

  5. If a change is not documentation-related, please add a tests if possible.

  6. Build and run tests

yarn build
yarn test
  1. Create a pull request

Document the changes

This project uses changesets. Every PR should include changes and their scopes for versioning. This can be done by:

yarn changeset

Answer all the prompted questions and commit to created files in .changeset folder.

For more on adding a changeset, see this.

Release new version

This section is done by maintainer only.

Run changeset version to bump all packages' versions and update CHANGELOG files:

yarn changeset version

Commit the changes:

git commit -a -m 'Version Packages'

Push the changes (with tags) to main.

git push && git push --tags