You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+8-7Lines changed: 8 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ Thank you for your interest in Troubleshoot, we welcome your participation. Plea
4
4
5
5
## Issues
6
6
7
-
-[Request a New Feature](https://github.com/replicatedhq/troubleshoot/issues/new?assignees=&labels=feature&template=feature_enhancement.md) Create an issue to add functionality that addresses a problem or adds an enhancement.
7
+
-[Request a New Feature](https://github.com/replicatedhq/troubleshoot/issues/new?assignees=&labels=feature&template=feature_enhancement.md) Create an issue to add functionality that addresses a problem or adds an enhancement.
8
8
-[Report a Bug](https://github.com/replicatedhq/troubleshoot/issues/new?assignees=&labels=bug&template=bug_report.md) Report a problem or unexpected behaviour with Troubleshoot.
9
9
10
10
## Design Principles
@@ -24,6 +24,8 @@ To get started we recommend:
24
24
> Note: recent versions of Go support easy cross-compilation. For example, to cross-compile a Linux binary from MacOS:
25
25
> `GOOS=linux GOARCH=amd64 make support-bundle preflight`
26
26
27
+
6. Install [golangci-lint] linter and run `make lint` to execute code linters.
28
+
27
29
### Testing
28
30
29
31
To run the tests locally run the following:
@@ -48,23 +50,22 @@ This is a rough outline of how to prepare a contribution:
48
50
- Create a topic branch from where you want to base your work (branched from `main` is a safe choice).
49
51
- Make commits of logical units.
50
52
- When your changes are ready to merge, squash your history to 1 commit.
51
-
- For example, if you want to squash your last 3 commits and write a new commit message:
53
+
- For example, if you want to squash your last 3 commits and write a new commit message:
52
54
```
53
-
git reset --soft HEAD~3 &&
55
+
git reset --soft HEAD~3 &&
54
56
git commit
55
-
```
57
+
```
56
58
57
59
- If you want to keep the previous commit messages and concatenate them all into a new commit, you can do something like this instead:
- Push your changes to a topic branch in your fork of the repository.
63
65
- Submit a pull request to the original repository. It will be reviewed in a timely manner.
64
66
65
67
### Pull Requests
66
68
67
-
A pull request should address a single issue, feature or bug. For example, lets say you've written code that fixes two issues. That's great! However, you should submit two small pull requests, one for each issue as opposed to combining them into a single larger pull request. In general the size of the pull request should be kept small in order to make it easy for a reviewer to understand, and to minimize risks from integrating many changes at the same time. For example, if you are working on a large feature you should break it into several smaller PRs by implementing the feature as changes to several packages and submitting a separate pull request for each one. Squash commit history when preparing your PR so it merges as 1 commit.
69
+
A pull request should address a single issue, feature or bug. For example, lets say you've written code that fixes two issues. That's great! However, you should submit two small pull requests, one for each issue as opposed to combining them into a single larger pull request. In general the size of the pull request should be kept small in order to make it easy for a reviewer to understand, and to minimize risks from integrating many changes at the same time. For example, if you are working on a large feature you should break it into several smaller PRs by implementing the feature as changes to several packages and submitting a separate pull request for each one. Squash commit history when preparing your PR so it merges as 1 commit.
68
70
69
71
Code submitted in pull requests must be properly documented, formatted and tested in order to be approved and merged. The following guidelines describe the things a reviewer will look for when they evaluate your pull request. Here's a tip. If your reviewer doesn't understand what the code is doing, they won't approve the pull request. Strive to make code clear and well documented. If possible, request a reviewer that has some context on the PR.
0 commit comments