Skip to content

Commit 9861780

Browse files
committed
Add CONTRIBUTING.md
Also add a "Contributing" section to the README.
1 parent 5c49054 commit 9861780

File tree

2 files changed

+37
-0
lines changed

2 files changed

+37
-0
lines changed

CONTRIBUTING.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
## Contributing
2+
3+
[fork]: https://github.com/github/git-sizer/fork
4+
[pr]: https://github.com/github/git-sizer/compare
5+
[code-of-conduct]: CODE_OF_CONDUCT.md
6+
7+
Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.
8+
9+
Please note that this project is released with a [Contributor Code of Conduct][code-of-conduct]. By participating in this project you agree to abide by its terms.
10+
11+
## Submitting a pull request
12+
13+
1. [Fork][fork] and clone the repository
14+
2. Configure and install the dependencies: `script/bootstrap`
15+
3. Make sure the tests pass on your machine: `make test`
16+
4. Create a new branch: `git checkout -b my-branch-name`
17+
5. Make your change, add tests, and make sure the tests still pass
18+
6. Push to your fork and [submit a pull request][pr]
19+
7. Pat your self on the back and wait for your pull request to be reviewed and merged.
20+
21+
Here are a few things you can do that will increase the likelihood of your pull request being accepted:
22+
23+
- Make sure that your code is formatted correctly: `make gofmt`.
24+
- Write tests.
25+
- 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.
26+
- Write a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).
27+
28+
## Resources
29+
30+
- [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)
31+
- [Using Pull Requests](https://help.github.com/articles/about-pull-requests/)
32+
- [GitHub Help](https://help.github.com)

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -196,3 +196,8 @@ $ git-sizer
196196
```
197197

198198
This repository is mischievously constructed to have a pathological tree structure, with the same directories repeated over and over again. As a result, even though the entire repository is less than 20 kb in size, when checked out it would explode into over a billion directories containing over ten billion files. (`git-sizer` prints `` for the blob count because the true number has overflowed the 32-bit counter used for that field.)
199+
200+
201+
## Contributing
202+
203+
`git-sizer` is in regular use and is still under active development. If you would like to help out, please see [`CONTRIBUTING.md`](CONTRIBUTING.md).

0 commit comments

Comments
 (0)