blob: df53d480d385679311fea0781de9526b705a56f6 [file] [log] [blame]
Andrew Gerrand7cb21a72012-01-19 11:24:54 +11001<!--{
Andrew Gerrandd84de092012-02-13 21:22:36 +11002 "Title": "The Go Project",
3 "Path": "/project/"
Andrew Gerrand7cb21a72012-01-19 11:24:54 +11004}-->
Andrew Gerrand6ab8d242010-09-16 14:01:02 +10005
Andrew Gerrandf200b722012-03-06 12:50:52 +11006<img class="gopher" src="/doc/gopher/project.png" />
7
Andrew Gerrand539178b2012-03-05 15:07:43 +11008<div id="manual-nav"></div>
9
10<p>
11Go is an open source project developed by a team at
Andrew Gerrand43ad89d2014-07-25 10:28:39 +100012<a href="//google.com/">Google</a> and many
Andrew Gerrand539178b2012-03-05 15:07:43 +110013<a href="/CONTRIBUTORS">contributors</a> from the open source community.
14</p>
15
16<p>
17Go is distributed under a <a href="/LICENSE">BSD-style license</a>.
18</p>
19
Andrew Gerrand43ad89d2014-07-25 10:28:39 +100020<h3 id="announce"><a href="//groups.google.com/group/golang-announce">Announcements Mailing List</a></h3>
Andrew Gerrandd70627e2012-03-06 15:16:02 +110021<p>
22A low traffic mailing list for important announcements, such as new releases.
23</p>
24<p>
25We encourage all Go users to subscribe to
Andrew Gerrand43ad89d2014-07-25 10:28:39 +100026<a href="//groups.google.com/group/golang-announce">golang-announce</a>.
Andrew Gerrandd70627e2012-03-06 15:16:02 +110027</p>
28
Andrew Gerrand5dd74172013-09-16 15:47:13 +100029
30<h2 id="go1">Version history</h2>
31
32<h3 id="release"><a href="/doc/devel/release.html">Release History</a></h3>
Andrew Gerrand5dd74172013-09-16 15:47:13 +100033
Andrew Gerrandc1374b52014-11-25 15:41:33 +110034<p>A <a href="/doc/devel/release.html">summary</a> of the changes between Go releases. Notes for the major releases:</p>
Andrew Gerrand5dd74172013-09-16 15:47:13 +100035
Andrew Gerrandc1374b52014-11-25 15:41:33 +110036<ul>
Russ Cox4f6035a2017-11-14 12:26:50 -050037 <li><a href="/doc/go1.10">Go 1.10</a> <small>(February 2018)</small></li>
Chris Broadfootace60742017-07-31 17:28:35 -070038 <li><a href="/doc/go1.9">Go 1.9</a> <small>(August 2017)</small></li>
Alberto Donizetti9230ee22017-02-23 19:36:34 +010039 <li><a href="/doc/go1.8">Go 1.8</a> <small>(February 2017)</small></li>
Chris Broadfoot35f55172016-08-15 17:28:00 -070040 <li><a href="/doc/go1.7">Go 1.7</a> <small>(August 2016)</small></li>
Chris Broadfoot00241012016-03-02 16:16:29 -080041 <li><a href="/doc/go1.6">Go 1.6</a> <small>(February 2016)</small></li>
Andrew Gerrand8389e7c2015-08-10 23:30:20 +000042 <li><a href="/doc/go1.5">Go 1.5</a> <small>(August 2015)</small></li>
Andrew Gerrandc1374b52014-11-25 15:41:33 +110043 <li><a href="/doc/go1.4">Go 1.4</a> <small>(December 2014)</small></li>
44 <li><a href="/doc/go1.3">Go 1.3</a> <small>(June 2014)</small></li>
45 <li><a href="/doc/go1.2">Go 1.2</a> <small>(December 2013)</small></li>
46 <li><a href="/doc/go1.1">Go 1.1</a> <small>(May 2013)</small></li>
47 <li><a href="/doc/go1">Go 1</a> <small>(March 2012)</small></li>
48</ul>
Andrew Gerrand5dd74172013-09-16 15:47:13 +100049
50<h3 id="go1compat"><a href="/doc/go1compat">Go 1 and the Future of Go Programs</a></h3>
51<p>
52What Go 1 defines and the backwards-compatibility guarantees one can expect as
53Go 1 matures.
54</p>
55
56
Andrew Gerrand539178b2012-03-05 15:07:43 +110057<h2 id="resources">Developer Resources</h2>
Andrew Gerrandd84de092012-02-13 21:22:36 +110058
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +110059<h3 id="source"><a href="https://golang.org/change">Source Code</a></h3>
Andrew Gerrandd84de092012-02-13 21:22:36 +110060<p>Check out the Go source code.</p>
61
Shenghou Ma8c9923d2014-06-01 22:48:57 -040062<h3 id="golang-dev"><a href="https://groups.google.com/group/golang-dev">Developer</a> and
63<a href="https://groups.google.com/group/golang-codereviews">Code Review Mailing List</a></h3>
64<p>The <a href="https://groups.google.com/group/golang-dev">golang-dev</a>
65mailing list is for discussing code changes to the Go project.
66The <a href="https://groups.google.com/group/golang-codereviews">golang-codereviews</a>
67mailing list is for actual reviewing of the code changes (CLs).</p>
Andrew Gerrandd84de092012-02-13 21:22:36 +110068
Shenghou Ma8c9923d2014-06-01 22:48:57 -040069<p>For general discussion of Go programming, see <a
70href="https://groups.google.com/group/golang-nuts">golang-nuts</a>.</p>
71
72<h3 id="golang-checkins"><a href="https://groups.google.com/group/golang-checkins">Checkins Mailing List</a></h3>
Andrew Gerrandd84de092012-02-13 21:22:36 +110073<p>A mailing list that receives a message summarizing each checkin to the Go repository.</p>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100074
Andrew Gerrand43ad89d2014-07-25 10:28:39 +100075<h3 id="build_status"><a href="//build.golang.org/">Build Status</a></h3>
Andrew Gerrand539178b2012-03-05 15:07:43 +110076<p>View the status of Go builds across the supported operating
77systems and architectures.</p>
78
79
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110080<h2 id="howto">How you can help</h2>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100081
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +110082<h3><a href="//golang.org/issue">Reporting issues</a></h3>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100083
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110084<p>
85If you spot bugs, mistakes, or inconsistencies in the Go project's code or
86documentation, please let us know by
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +110087<a href="//golang.org/issue/new">filing a ticket</a>
88on our <a href="//golang.org/issue">issue tracker</a>.
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110089(Of course, you should check it's not an existing issue before creating
90a new one.)
91</p>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100092
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110093<p>
94We pride ourselves on being meticulous; no issue is too small.
95</p>
96
Andrew Gerranda1cc84f2015-06-26 08:46:30 +100097<p>
Andrew Gerrand499c8272015-08-27 15:40:46 +100098Security-related issues should be reported to
Andrew Gerrand90ffb7c2015-11-24 14:39:03 +110099<a href="mailto:security@golang.org">security@golang.org</a>.<br>
Andrew Gerrand499c8272015-08-27 15:40:46 +1000100See the <a href="/security">security policy</a> for more details.
Andrew Gerranda1cc84f2015-06-26 08:46:30 +1000101</p>
102
Andrew Gerrand90ffb7c2015-11-24 14:39:03 +1100103<p>
104Community-related issues should be reported to
105<a href="mailto:conduct@golang.org">conduct@golang.org</a>.<br>
106See the <a href="/conduct">Code of Conduct</a> for more details.
107</p>
108
Bobby Powersd5b28ad2012-02-20 08:33:28 +1100109<h3><a href="/doc/contribute.html">Contributing code</a></h3>
Andrew Gerrandeccf31b2011-03-24 11:06:02 +1100110
111<p>
112Go is an open source project and we welcome contributions from the community.
113</p>
114<p>
Bobby Powersd5b28ad2012-02-20 08:33:28 +1100115To get started, read these <a href="/doc/contribute.html">contribution
Andrew Gerrandeccf31b2011-03-24 11:06:02 +1100116guidelines</a> for information on design, testing, and our code review process.
117</p>
118<p>
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +1100119Check <a href="//golang.org/issue">the tracker</a> for
Andrew Gerrandeccf31b2011-03-24 11:06:02 +1100120open issues that interest you. Those labeled
Stanislav Afanasev2fb9fe42017-12-11 23:45:19 +0300121<a href="https://github.com/golang/go/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22">help wanted</a>
Andrew Gerrandeccf31b2011-03-24 11:06:02 +1100122are particularly in need of outside help.
123</p>