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
|
2023-10-08 12:55:40 +02:00
|
|
|
To do so, please read the following simple steps on how to contribute. This will
|
|
|
|
make life easier and will avoid wasting time on things which are not
|
2015-07-15 08:37:00 +02:00
|
|
|
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:
|
|
|
|
|
2016-04-26 06:55:05 +02:00
|
|
|
|
|
|
|
|
2015-07-15 08:37:00 +02:00
|
|
|
[1]: https://github.com/IonicaBizau/git-stats/issues
|
2015-11-01 11:39:28 +01:00
|
|
|
|
2016-04-26 06:55:05 +02:00
|
|
|
[2]: https://github.com/IonicaBizau/code-style
|