mirror of
https://github.com/golang/go
synced 2024-11-12 07:00:21 -07:00
5dd74175d4
Remove "References" section. Remove most articles and redirect to blog.golang.org. Move /ref/spec and /ref/mem to /doc/spec and /doc/mem. Remove duplicate links from the remaining "Documents", "The Project", and "Help" pages. Defer to the wiki for more links and community content. Update command reference and mention cover tool. Add "Pop-out" text to the front page. Pick one of four videos at random to feature on the front page. Fixes #2547. Fixes #5561. Fixes #6321. R=r, dominik.honnef CC=golang-dev https://golang.org/cl/13724043
195 lines
7.7 KiB
HTML
195 lines
7.7 KiB
HTML
<!--{
|
|
"Title": "Documentation",
|
|
"Path": "/doc/"
|
|
}-->
|
|
|
|
<p>
|
|
The Go programming language is an open source project to make programmers more
|
|
productive.
|
|
</p>
|
|
|
|
<p>
|
|
Go is expressive, concise, clean, and efficient. Its concurrency
|
|
mechanisms make it easy to write programs that get the most out of multicore
|
|
and networked machines, while its novel type system enables flexible and
|
|
modular program construction. Go compiles quickly to machine code yet has the
|
|
convenience of garbage collection and the power of run-time reflection. It's a
|
|
fast, statically typed, compiled language that feels like a dynamically typed,
|
|
interpreted language.
|
|
</p>
|
|
|
|
<div id="manual-nav"></div>
|
|
|
|
<h2>Installing Go</h2>
|
|
|
|
<h3><a href="/doc/install">Getting Started</a></h3>
|
|
<p>
|
|
Instructions for downloading and installing the Go compilers, tools, and
|
|
libraries.
|
|
</p>
|
|
|
|
|
|
<h2 id="learning">Learning Go</h2>
|
|
|
|
<img class="gopher" src="/doc/gopher/doc.png"/>
|
|
|
|
<h3 id="go_tour"><a href="http://tour.golang.org/">A Tour of Go</a></h3>
|
|
<p>
|
|
An interactive introduction to Go in three sections.
|
|
The first section covers basic syntax and data structures; the second discusses
|
|
methods and interfaces; and the third introduces Go's concurrency primitives.
|
|
Each section concludes with a few exercises so you can practice what you've
|
|
learned. You can <a href="http://tour.golang.org/">take the tour online</a> or
|
|
<a href="http://code.google.com/p/go-tour/">install it locally</a>.
|
|
</p>
|
|
|
|
<h3 id="code"><a href="code.html">How to write Go code</a></h3>
|
|
<p>
|
|
Also available as a
|
|
<a href="http://www.youtube.com/watch?v=XCsL89YtqCs">screencast</a>, this doc
|
|
explains how to use the <a href="/cmd/go/">go command</a> to fetch, build, and
|
|
install packages, commands, and run tests.
|
|
</p>
|
|
|
|
<h3 id="effective_go"><a href="effective_go.html">Effective Go</a></h3>
|
|
<p>
|
|
A document that gives tips for writing clear, idiomatic Go code.
|
|
A must read for any new Go programmer. It augments the tour and
|
|
the language specification, both of which should be read first.
|
|
</p>
|
|
|
|
<h3 id="faq"><a href="/doc/faq">Frequently Asked Questions (FAQ)</a></h3>
|
|
<p>
|
|
Answers to common questions about Go.
|
|
</p>
|
|
|
|
<h3 id="wiki"><a href="/wiki">The Go Wiki</a></h3>
|
|
<p>A wiki maintained by the Go community.</p>
|
|
|
|
<h4 id="learn_more">More</h4>
|
|
<p>
|
|
See the <a href="/wiki/Learn">Learn</a> page at the <a href="/wiki">Wiki</a>
|
|
for more Go learning resources.
|
|
</p>
|
|
|
|
|
|
<h2 id="references">References</h2>
|
|
|
|
<h3 id="pkg"><a href="/pkg/">Package Documentation</a></h3>
|
|
<p>
|
|
The documentation for the Go standard library.
|
|
</p>
|
|
|
|
<h3 id="cmd"><a href="/doc/cmd">Command Documentation</a></h3>
|
|
<p>
|
|
The documentation for the Go tools.
|
|
</p>
|
|
|
|
<h3 id="spec"><a href="/ref/spec">Language Specification</a></h3>
|
|
<p>
|
|
The official Go Language specification.
|
|
</p>
|
|
|
|
<h3 id="go_mem"><a href="/ref/mem">The Go Memory Model</a></h3>
|
|
<p>
|
|
A document that specifies the conditions under which reads of a variable in
|
|
one goroutine can be guaranteed to observe values produced by writes to the
|
|
same variable in a different goroutine.
|
|
</p>
|
|
|
|
|
|
<h2 id="articles">Articles</h2>
|
|
|
|
<h3 id="blog"><a href="http://blog.golang.org/">The Go Blog</a></h3>
|
|
<p>The official blog of the Go project, featuring news and in-depth articles by
|
|
the Go team and guests.</p>
|
|
|
|
<h4>Codewalks</h4>
|
|
<p>
|
|
Guided tours of Go programs.
|
|
</p>
|
|
<ul>
|
|
<li><a href="/doc/codewalk/functions">First-Class Functions in Go</a></li>
|
|
<li><a href="/doc/codewalk/markov">Generating arbitrary text: a Markov chain algorithm</a></li>
|
|
<li><a href="/doc/codewalk/sharemem">Share Memory by Communicating</a></li>
|
|
<li><a href="/doc/articles/wiki/">Writing Web Applications</a> - building a simple web application.</li>
|
|
</ul>
|
|
|
|
<h4>Language</h4>
|
|
<ul>
|
|
<li><a href="/blog/json-rpc-tale-of-interfaces">JSON-RPC: a tale of interfaces</a></li>
|
|
<li><a href="/blog/gos-declaration-syntax">Go's Declaration Syntax</a></li>
|
|
<li><a href="/blog/defer-panic-and-recover">Defer, Panic, and Recover</a></li>
|
|
<li><a href="/blog/go-concurrency-patterns-timing-out-and">Go Concurrency Patterns: Timing out, moving on</a></li>
|
|
<li><a href="/blog/go-slices-usage-and-internals">Go Slices: usage and internals</a></li>
|
|
<li><a href="/blog/gif-decoder-exercise-in-go-interfaces">A GIF decoder: an exercise in Go interfaces</a></li>
|
|
<li><a href="/blog/error-handling-and-go">Error Handling and Go</a></li>
|
|
<li><a href="/blog/organizing-go-code">Organizing Go code</a></li>
|
|
</ul>
|
|
|
|
<h4>Packages</h4>
|
|
<ul>
|
|
<li><a href="/blog/json-and-go">JSON and Go</a> - using the <a href="/pkg/encoding/json/">json</a> package.</li>
|
|
<li><a href="/blog/gobs-of-data">Gobs of data</a> - the design and use of the <a href="/pkg/encoding/gob/">gob</a> package.</li>
|
|
<li><a href="/blog/laws-of-reflection">The Laws of Reflection</a> - the fundamentals of the <a href="/pkg/reflect/">reflect</a> package.</li>
|
|
<li><a href="/blog/go-image-package">The Go image package</a> - the fundamentals of the <a href="/pkg/image/">image</a> package.</li>
|
|
<li><a href="/blog/go-imagedraw-package">The Go image/draw package</a> - the fundamentals of the <a href="/pkg/image/draw/">image/draw</a> package.</li>
|
|
</ul>
|
|
|
|
<h4>Tools</h4>
|
|
<ul>
|
|
<li><a href="/doc/articles/go_command.html">About the Go command</a> - why we wrote it, what it is, what it's not, and how to use it.</li>
|
|
<li><a href="/blog/c-go-cgo">C? Go? Cgo!</a> - linking against C code with <a href="/cmd/cgo/">cgo</a>.</li>
|
|
<li><a href="/doc/gdb">Debugging Go Code with GDB</a></li>
|
|
<li><a href="/blog/godoc-documenting-go-code">Godoc: documenting Go code</a> - writing good documentation for <a href="/cmd/godoc/">godoc</a>.</li>
|
|
<li><a href="/blog/profiling-go-programs">Profiling Go Programs</a></li>
|
|
<li><a href="/blog/race-detector">Data Race Detector</a> - testing Go programs for race conditions.</li>
|
|
</ul>
|
|
|
|
<h4 id="articles_more">More</h4>
|
|
<p>
|
|
See the <a href="/wiki/Articles">Articles page</a> at the
|
|
<a href="/wiki">Wiki</a> for more Go articles.
|
|
</p>
|
|
|
|
|
|
<h2 id="talks">Talks</h2>
|
|
|
|
<img class="gopher" src="/doc/gopher/talks.png"/>
|
|
|
|
<h3 id="video_tour_of_go"><a href="http://research.swtch.com/gotour">A Video Tour of Go</a></h3>
|
|
<p>
|
|
Three things that make Go fast, fun, and productive:
|
|
interfaces, reflection, and concurrency. Builds a toy web crawler to
|
|
demonstrate these.
|
|
</p>
|
|
|
|
<h3 id="go_code_that_grows"><a href="http://vimeo.com/53221560">Code that grows with grace</a></h3>
|
|
<p>
|
|
One of Go's key design goals is code adaptability; that it should be easy to take a simple design and build upon it in a clean and natural way. In this talk Andrew Gerrand describes a simple "chat roulette" server that matches pairs of incoming TCP connections, and then use Go's concurrency mechanisms, interfaces, and standard library to extend it with a web interface and other features. While the function of the program changes dramatically, Go's flexibility preserves the original design as it grows.
|
|
</p>
|
|
|
|
<h3 id="go_concurrency_patterns"><a href="http://www.youtube.com/watch?v=f6kdp27TYZs">Go Concurrency Patterns</a></h3>
|
|
<p>
|
|
Concurrency is the key to designing high performance network services. Go's concurrency primitives (goroutines and channels) provide a simple and efficient means of expressing concurrent execution. In this talk we see how tricky concurrency problems can be solved gracefully with simple Go code.
|
|
</p>
|
|
|
|
<h3 id="advanced_go_concurrency_patterns"><a href="http://www.youtube.com/watch?v=QDDwwePbDtw">Advanced Go Concurrency Patterns</a></h3>
|
|
<p>
|
|
This talk expands on the <i>Go Concurrency Patterns</i> talk to dive deeper into Go's concurrency primitives.
|
|
</p>
|
|
|
|
<h4 id="talks_more">More</h4>
|
|
<p>
|
|
See the <a href="/talks">Go Talks site</a> and <a href="/wiki/GoTalks">wiki page</a> for more Go talks.
|
|
</p>
|
|
|
|
|
|
<h2 id="nonenglish">Non-English Documentation</h2>
|
|
|
|
<p>
|
|
See the <a href="/wiki/NonEnglish">NonEnglish</a> page
|
|
at the <a href="/wiki">Wiki</a> for localized
|
|
documentation.
|
|
</p>
|