👋 Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.
If you already know what to contribute, skip this session
You could to check our issues board into our issue board. There you can find a issue list labeled with effort and priority, the higher the card is the most important issue to be solved at the moment. Just send a comment to check if you can implements the feature/fix and starting code :)
[Pull Requests][pulls] are used for adding new playbooks, roles, and documents to the repository, or editing the existing ones.
With write access
- Open a issue
- After some discussion, label your issue with
WIP
- Clone the repository (only if you have write access)
- Create a new branch:
git checkout -b my-branch-name
- Make your change
- Is super important to use
npm run commit
to commit your files because we use semantic-commit, so this script force you to use linter and wil format your commit message to semantic-release bot can publish your new feature. - Push and [submit a pull request][pr]
- Pat yourself on the back and wait for your pull request to be reviewed and merged.
Without write access
- Open a issue
- After some discussion, label your issue with
WIP
- [Fork][fork] and clone the repository
- Create a new branch:
git checkout -b my-branch-name
- Make your change
- Is super important to use
npm run commit
to commit your files because we use semantic-commit, so this script force you to use linter and wil format your commit message to semantic-release bot can publish your new feature. - Push to your fork and [submit a pull request][pr]
- Pat your self on the back and wait for your pull request to be reviewed and merged.
Here are a few things you can do that will increase the likelihood of your pull request being accepted:
- Keep your change as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.
- Write good commit messages.
Draft pull requests are also welcome to get feedback early on, or if there is something blocking you.
- Create a branch with a name that identifies the user and nature of the changes (similar to
user/branch-purpose
)
Commit Structure All the Herbs organization libraries uses seemantic release and commitizen to :
- Generate changelog
- Control version
- Publish to npm via github actions
Please use
npm run commit
for commit .