git-stats/CONTRIBUTING.md

64 lines
2.5 KiB
Markdown
Raw Normal View History

2015-07-15 08:37:00 +02:00
# :eight_spoked_asterisk: :stars: :sparkles: :dizzy: :star2: :star2: :sparkles: :dizzy: :star2: :star2: Contributing :star: :star2: :dizzy: :sparkles: :star: :star2: :dizzy: :sparkles: :stars: :eight_spoked_asterisk:
So, you want to contribute to this project! That's awesome. However, before
doing so, please read the following simple steps how to contribute. This will
make the life easier and will avoid wasting time on things which are not
requested. :sparkles:
## Discuss the changes before doing them
- First of all, open an issue in the repository, using the [bug tracker][1],
2015-11-01 11:39:28 +01:00
describing the contribution you would like to make, the bug you found or any
2015-07-15 08:37:00 +02:00
other ideas you have. This will help us to get you started on the right
foot.
- If it makes sense, add the platform and software information (e.g. operating
2015-11-01 11:39:28 +01:00
system, Node.JS version etc.), screenshots (so we can see what you are
seeing).
2015-07-15 08:37:00 +02:00
2015-11-01 11:39:28 +01:00
- It is recommended to wait for feedback before continuing to next steps.
However, if the issue is clear (e.g. a typo) and the fix is simple, you can
continue and fix it.
2015-07-15 08:37:00 +02:00
## Fixing issues
- Fork the project in your account and create a branch with your fix:
`some-great-feature` or `some-issue-fix`.
- Commit your changes in that branch, writing the code following the
[code style][2]. If the project contains tests (generally, the `test`
directory), you are encouraged to add a test as well. :memo:
2015-11-01 11:39:28 +01:00
- If the project contains a `package.json` or a `bower.json` file add yourself
in the `contributors` array (or `authors` in the case of `bower.json`;
if the array does not exist, create it):
2015-07-15 08:37:00 +02:00
```json
{
"contributors": [
2015-11-01 11:39:28 +01:00
"Your Name <and@email.address> (http://your.website)"
2015-07-15 08:37:00 +02:00
]
}
```
## Creating a pull request
- Open a pull request, and reference the initial issue in the pull request
2015-11-01 11:39:28 +01:00
message (e.g. *fixes #<your-issue-number>*). Write a good description and
2015-07-15 08:37:00 +02:00
title, so everybody will know what is fixed/improved.
2015-11-01 11:39:28 +01:00
- If it makes sense, add screenshots, gifs etc., so it is easier to see what
is going on.
2015-07-15 08:37:00 +02:00
## Wait for feedback
Before accepting your contributions, we will review them. You may get feedback
about what should be fixed in your modified code. If so, just keep committing
in your branch and the pull request will be updated automatically.
## Everyone is happy!
Finally, your contributions will be merged, and everyone will be happy! :smile:
2015-11-01 11:39:28 +01:00
Contributions are more than welcome!
2015-07-15 08:37:00 +02:00
Thanks! :sweat_smile:
[1]: https://github.com/IonicaBizau/git-stats/issues
2015-11-01 11:39:28 +01:00
2015-07-15 08:37:00 +02:00
[2]: https://github.com/IonicaBizau/code-style