Contributing to TailorX
January 30, 2020 · View on GitHub
Thank you for your interest in making TailorX even better and more awesome. Your contributions are highly welcome.
There are multiple ways of getting involved:
Below are a few guidelines we would like you to follow. If you need help, please reach out to one or more of the maintainers.
Report a bug
Reporting bugs is one of the best ways to contribute. Before creating a bug report, please check that an issue reporting the same problem does not already exist. If there is an such an issue, you may add your information as a comment.
To report a new bug you should open an issue that summarizes the bug and set the label to "bug".
If you want to provide a fix along with your bug report: That is great! In this case please send us a pull request as described in section [Contribute Code] (#contribute-code).
Suggest a feature
To request a new feature you should open a GitHub issue and summarize the desired functionality and its use case. Set the issue label to "feature".
Contribute code
This is a rough outline of what the workflow for code contributions looks like:
- Check the list of open issues at GitHub. Either assign an existing issue to yourself, or create a new one that you would like work on and discuss your ideas and use cases.
- Fork the repository on GitHub
- Create a topic branch from where you want to base your work. This is usually master.
- Make commits of logical units.
- Write good commit messages (see below).
- Push your changes to a topic branch in your fork of the repository.
- Submit a pull request
- Your pull request must receive a :thumbsup: from two maintainers
Thanks for your contributions!
Commit messages
Your commit messages ideally can answer two questions: what changed and why. The subject line should feature the “what” and the body of the commit should describe the “why”.
When creating a pull request, its comment should reference the corresponding issue id.
Have fun and enjoy hacking!
New version release
To release new version of package use the following steps:
$ npx -p conventional-changelog-angular -p conventional-changelog-preset-loader -p conventional-recommended-bump conventional-recommended-bump --preset angular
$ npm version [major | minor | patch]
# Review last commit
$ git push && git push --tags
$ npm publish