-
Notifications
You must be signed in to change notification settings - Fork 295
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #384 from ahmetcetin/patch-1
Create CONTRIBUTING.md
- Loading branch information
Showing
1 changed file
with
31 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
# Contributing to GroupButler | ||
Contributing to GroupButler isn't limited to just filing bugs, users are more than welcomed to make suggestions, report any issue they may find, and make pull requests to help make GroupButler better. | ||
|
||
## Working on GroupButler | ||
### Prerequisites | ||
* [Git](https://git-scm.com/) | ||
|
||
### Getting GroupButler | ||
1. Fork a copy of our repo | ||
2. Open up Git in an environment of your choice | ||
3. Run the following | ||
|
||
```bash | ||
$ git clone https://github.com/group-butler/GroupButler.git | ||
$ cd GroupButler | ||
``` | ||
|
||
### Please pay attention to | ||
1. Open an issue describing the feature/bug you wish to contribute first to start a discussion, explain why, what and how | ||
2. Write tests covering 100% of the library code you produce. Don't send PRs which reduce the coverage status | ||
3. One PR per feature/fix unless you follow [standard-version](https://github.com/conventional-changelog/standard-version) commit guidelines | ||
4. Naming convention: PascalCase for Classes, camelCase for methods and snake_case for other stuff | ||
|
||
### Using branches | ||
When working on any issue on Github, it's a good practice to make branches that are specific to the issue you're currently working on. For instance, if you're working on an issue with a name like "NAME OF ISSUE #1234", from the master branch run the following code: `git checkout -b Issue#1234`. In doing so, you'll be making a branch that specifically identifies the issue at hand, and moves you right into it with the `checkout` flag. This keeps your main (master) repository clean and your personal workflow cruft out of sight when making a pull request. | ||
|
||
### Finding issues to fix | ||
After you've forked and cloned our repo, you can find issues to work on by heading over to our [issues list](https://github.com/group-butler/GroupButler/issues). We advise looking at the issues with the labels [help wanted](https://github.com/group-butler/GroupButler/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) or [good first issue](https://github.com/group-butler/GroupButler/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22), as they will help you get familiar with the GroupButler code. | ||
|
||
### Rules of the discussions | ||
Remember to be very clear and transparent when discussing any issue in the discussions boards. We ask that you keep the language to English and keep on track with the issue at hand. Lastly, please be respectful of our fellow contributors and keep an exemplary level of professionalism at all times. |