blob: 56674917432dc22827d6cf33b77808e708eae259 [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>
Andrew Gerrand8389e7c2015-08-10 23:30:20 +000037 <li><a href="/doc/go1.5">Go 1.5</a> <small>(August 2015)</small></li>
Andrew Gerrandc1374b52014-11-25 15:41:33 +110038 <li><a href="/doc/go1.4">Go 1.4</a> <small>(December 2014)</small></li>
39 <li><a href="/doc/go1.3">Go 1.3</a> <small>(June 2014)</small></li>
40 <li><a href="/doc/go1.2">Go 1.2</a> <small>(December 2013)</small></li>
41 <li><a href="/doc/go1.1">Go 1.1</a> <small>(May 2013)</small></li>
42 <li><a href="/doc/go1">Go 1</a> <small>(March 2012)</small></li>
43</ul>
Andrew Gerrand5dd74172013-09-16 15:47:13 +100044
45<h3 id="go1compat"><a href="/doc/go1compat">Go 1 and the Future of Go Programs</a></h3>
46<p>
47What Go 1 defines and the backwards-compatibility guarantees one can expect as
48Go 1 matures.
49</p>
50
51
Andrew Gerrand539178b2012-03-05 15:07:43 +110052<h2 id="resources">Developer Resources</h2>
Andrew Gerrandd84de092012-02-13 21:22:36 +110053
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +110054<h3 id="source"><a href="https://golang.org/change">Source Code</a></h3>
Andrew Gerrandd84de092012-02-13 21:22:36 +110055<p>Check out the Go source code.</p>
56
Shenghou Ma8c9923d2014-06-01 22:48:57 -040057<h3 id="golang-dev"><a href="https://groups.google.com/group/golang-dev">Developer</a> and
58<a href="https://groups.google.com/group/golang-codereviews">Code Review Mailing List</a></h3>
59<p>The <a href="https://groups.google.com/group/golang-dev">golang-dev</a>
60mailing list is for discussing code changes to the Go project.
61The <a href="https://groups.google.com/group/golang-codereviews">golang-codereviews</a>
62mailing list is for actual reviewing of the code changes (CLs).</p>
Andrew Gerrandd84de092012-02-13 21:22:36 +110063
Shenghou Ma8c9923d2014-06-01 22:48:57 -040064<p>For general discussion of Go programming, see <a
65href="https://groups.google.com/group/golang-nuts">golang-nuts</a>.</p>
66
67<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 +110068<p>A mailing list that receives a message summarizing each checkin to the Go repository.</p>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100069
Andrew Gerrand43ad89d2014-07-25 10:28:39 +100070<h3 id="build_status"><a href="//build.golang.org/">Build Status</a></h3>
Andrew Gerrand539178b2012-03-05 15:07:43 +110071<p>View the status of Go builds across the supported operating
72systems and architectures.</p>
73
74
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110075<h2 id="howto">How you can help</h2>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100076
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +110077<h3><a href="//golang.org/issue">Reporting issues</a></h3>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100078
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110079<p>
80If you spot bugs, mistakes, or inconsistencies in the Go project's code or
81documentation, please let us know by
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +110082<a href="//golang.org/issue/new">filing a ticket</a>
83on our <a href="//golang.org/issue">issue tracker</a>.
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110084(Of course, you should check it's not an existing issue before creating
85a new one.)
86</p>
Andrew Gerrand6ab8d242010-09-16 14:01:02 +100087
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110088<p>
89We pride ourselves on being meticulous; no issue is too small.
90</p>
91
Andrew Gerranda1cc84f2015-06-26 08:46:30 +100092<p>
93Sensitive security-related issues should be reported to <a href="mailto:security@golang.org">security@golang.org</a>.
94</p>
95
Bobby Powersd5b28ad2012-02-20 08:33:28 +110096<h3><a href="/doc/contribute.html">Contributing code</a></h3>
Andrew Gerrandeccf31b2011-03-24 11:06:02 +110097
98<p>
99Go is an open source project and we welcome contributions from the community.
100</p>
101<p>
Bobby Powersd5b28ad2012-02-20 08:33:28 +1100102To get started, read these <a href="/doc/contribute.html">contribution
Andrew Gerrandeccf31b2011-03-24 11:06:02 +1100103guidelines</a> for information on design, testing, and our code review process.
104</p>
105<p>
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +1100106Check <a href="//golang.org/issue">the tracker</a> for
Andrew Gerrandeccf31b2011-03-24 11:06:02 +1100107open issues that interest you. Those labeled
Andrew Gerrandeb91b5f2014-12-10 11:01:55 +1100108<a href="https://github.com/golang/go/issues?q=is%3Aopen+is%3Aissue+label%3Ahelpwanted">helpwanted</a>
Andrew Gerrandeccf31b2011-03-24 11:06:02 +1100109are particularly in need of outside help.
110</p>