| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 1 | # Contributing to Go |
| Andrew Gerrand | 0f2db82 | 2014-12-08 22:05:57 +1100 | [diff] [blame] | 2 | |
| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 3 | Go is an open source project. |
| Andrew Gerrand | 0f2db82 | 2014-12-08 22:05:57 +1100 | [diff] [blame] | 4 | |
| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 5 | It is the work of hundreds of contributors. We appreciate your help! |
| Andrew Gerrand | 0f2db82 | 2014-12-08 22:05:57 +1100 | [diff] [blame] | 6 | |
| Paul Jolly | e0d50a5 | 2016-12-09 11:15:23 +0000 | [diff] [blame] | 7 | ## Before filing an issue |
| 8 | |
| 9 | If you are unsure whether you have found a bug, please consider asking in the [golang-nuts mailing |
| 10 | list](https://groups.google.com/forum/#!forum/golang-nuts) or [other forums](https://golang.org/help/) first. If |
| 11 | the behavior you are seeing is confirmed as a bug or issue, it can easily be re-raised in the issue tracker. |
| Andrew Gerrand | 0f2db82 | 2014-12-08 22:05:57 +1100 | [diff] [blame] | 12 | |
| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 13 | ## Filing issues |
| Andrew Gerrand | 0f2db82 | 2014-12-08 22:05:57 +1100 | [diff] [blame] | 14 | |
| Paul Jolly | e0d50a5 | 2016-12-09 11:15:23 +0000 | [diff] [blame] | 15 | Sensitive security-related issues should be reported to [security@golang.org](mailto:security@golang.org). |
| 16 | See the [security policy](https://golang.org/security) for details. |
| Brad Fitzpatrick | 5ddfa69 | 2017-01-06 22:45:17 +0000 | [diff] [blame] | 17 | |
| Josh Bleecher Snyder | 7c946c6 | 2017-07-24 09:54:13 -0700 | [diff] [blame] | 18 | The recommended way to file an issue is by running `go bug`. |
| Paul Jolly | e0d50a5 | 2016-12-09 11:15:23 +0000 | [diff] [blame] | 19 | Otherwise, when filing an issue, make sure to answer these five questions: |
| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 20 | |
| 21 | 1. What version of Go are you using (`go version`)? |
| 22 | 2. What operating system and processor architecture are you using? |
| 23 | 3. What did you do? |
| 24 | 4. What did you expect to see? |
| 25 | 5. What did you see instead? |
| 26 | |
| Brad Fitzpatrick | 5ddfa69 | 2017-01-06 22:45:17 +0000 | [diff] [blame] | 27 | For change proposals, see [Proposing Changes To Go](https://github.com/golang/proposal/). |
| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 28 | |
| 29 | ## Contributing code |
| 30 | |
| Paul Jolly | e0d50a5 | 2016-12-09 11:15:23 +0000 | [diff] [blame] | 31 | Please read the [Contribution Guidelines](https://golang.org/doc/contribute.html) before sending patches. |
| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 32 | |
| Andrew Gerrand | 69f24cf | 2014-12-11 09:44:54 +1100 | [diff] [blame] | 33 | Unless otherwise noted, the Go source files are distributed under |
| Andrew Gerrand | 495e02d | 2014-12-10 16:06:47 +1100 | [diff] [blame] | 34 | the BSD-style license found in the LICENSE file. |
| Andrew Gerrand | 0f2db82 | 2014-12-08 22:05:57 +1100 | [diff] [blame] | 35 | |
