1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
# Contribution Guide
- [Before you get started](#before-you-get-started)
- [Code of Conduct](#code-of-conduct)
- [Your First Contribution](#your-first-contribution)
- [Find a good first topic](#find-a-good-first-topic)
- [Setting up your development environment](#setting-up-your-development-environment)
- [Fork the project](#fork-the-project)
- [Clone the project](#clone-the-project)
- [New branch for a new code](#new-branch-for-a-new-code)
- [Test](#test)
- [Commit and push](#commit-and-push)
- [Create a Pull Request](#create-a-pull-request)
- [Sign the CLA](#sign-the-cla)
- [Get a code review](#get-a-code-review)
## Before you get started
### Code of Conduct
Please make sure to read and observe our [Code of Conduct](./CODE_OF_CONDUCT.md).
## Your First Contribution
### Find a good first topic
You can start by finding an existing issue with the
[good first issue](https://github.com/hypermodeinc/badger/labels/good%20first%20issue) or
[help wanted](https://github.com/hypermodeinc/badger/labels/help%20wanted) labels. These issues are
well suited for new contributors.
## Setting up your development environment
Badger uses [`Go Modules`](https://github.com/golang/go/wiki/Modules) to manage dependencies. The
version of Go should be **1.12** or above.
### Fork the project
- Visit https://github.com/hypermodeinc/badger
- Click the `Fork` button (top right) to create a fork of the repository
### Clone the project
```sh
git clone https://github.com/$GITHUB_USER/badger
cd badger
git remote add upstream git@github.com:hypermodeinc/badger.git
# Never push to the upstream master
git remote set-url --push upstream no_push
```
### New branch for a new code
Get your local master up to date:
```sh
git fetch upstream
git checkout master
git rebase upstream/master
```
Create a new branch from the master:
```sh
git checkout -b my_new_feature
```
And now you can finally add your changes to project.
### Test
Build and run all tests:
```sh
./test.sh
```
### Commit and push
Commit your changes:
```sh
git commit
```
When the changes are ready to review:
```sh
git push origin my_new_feature
```
### Create a Pull Request
Just open `https://github.com/$GITHUB_USER/badger/pull/new/my_new_feature` and fill the PR
description.
### Sign the CLA
Click the **Sign in with Github to agree** button to sign the CLA.
[An example](https://cla-assistant.io/hypermodeinc/badger?pullRequest=1377).
### Get a code review
If your pull request (PR) is opened, it will be assigned to one or more reviewers. Those reviewers
will do a code review.
To address review comments, you should commit the changes to the same branch of the PR on your fork.
|
