diff options
Diffstat (limited to 'doc/docs.html')
-rw-r--r-- | doc/docs.html | 142 |
1 files changed, 58 insertions, 84 deletions
diff --git a/doc/docs.html b/doc/docs.html index 2dcab5d51..7aad8dadf 100644 --- a/doc/docs.html +++ b/doc/docs.html @@ -58,43 +58,47 @@ 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="ref"><a href="/ref/">Go References</a></h3> -<p>Language specification, memory model, and detailed documentation for the commands and packages.</p> - -<h3 id="appengine"><a href="https://developers.google.com/appengine/docs/go/gettingstarted/">Getting Started with Go on App Engine</a></h3> +<h3 id="faq"><a href="/doc/faq">Frequently Asked Questions (FAQ)</a></h3> <p> -How to develop and deploy a simple Go project with -<a href="https://developers.google.com/appengine/">Google App Engine</a>. +Answers to common questions about Go. </p> -<h3 id="go_faq"><a href="go_faq.html">Frequently Asked Questions (FAQ)</a></h3> +<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> -Answers to common questions about Go. +See the <a href="/wiki/Learn">Learn</a> page at the <a href="/wiki">Wiki</a> +for more Go learning resources. </p> -<h3 id="wiki"><a href="http://code.google.com/p/go-wiki/wiki">Go Language Community Wiki</a></h3> -<p>A wiki maintained by the Go community.</p> -<h2 id="go1">Go version 1</h2> +<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="go1notes"><a href="/doc/go1.html">Go 1 Release Notes</a></h3> +<h3 id="cmd"><a href="/doc/cmd">Command Documentation</a></h3> <p> -A guide for updating your code to work with Go 1. +The documentation for the Go tools. </p> -<h3 id="go1.1notes"><a href="/doc/go1.1.html">Go 1.1 Release Notes</a></h3> +<h3 id="spec"><a href="/ref/spec">Language Specification</a></h3> <p> -A list of significant changes in Go 1.1, with instructions for updating your -code where necessary. +The official Go Language specification. </p> -<h3 id="go1compat"><a href="/doc/go1compat.html">Go 1 and the Future of Go Programs</a></h3> +<h3 id="go_mem"><a href="/ref/mem">The Go Memory Model</a></h3> <p> -What Go 1 defines and the backwards-compatibility guarantees one can expect as -Go 1 matures. +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">Go Articles</h2> + +<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 @@ -113,44 +117,46 @@ Guided tours of Go programs. <h4>Language</h4> <ul> -<li><a href="/doc/articles/json_rpc_tale_of_interfaces.html">JSON-RPC: a tale of interfaces</a></li> -<li><a href="/doc/articles/gos_declaration_syntax.html">Go's Declaration Syntax</a></li> -<li><a href="/doc/articles/defer_panic_recover.html">Defer, Panic, and Recover</a></li> -<li><a href="/doc/articles/concurrency_patterns.html">Go Concurrency Patterns: Timing out, moving on</a></li> -<li><a href="/doc/articles/slices_usage_and_internals.html">Go Slices: usage and internals</a></li> -<li><a href="http://blog.golang.org/2011/05/gif-decoder-exercise-in-go-interfaces.html">A GIF decoder: an exercise in Go interfaces</a></li> -<li><a href="/doc/articles/error_handling.html">Error Handling and Go</a></li> +<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="/doc/articles/json_and_go.html">JSON and Go</a> - using the <a href="/pkg/encoding/json/">json</a> package.</li> -<li><a href="/doc/articles/gobs_of_data.html">Gobs of data</a> - the design and use of the <a href="/pkg/encoding/gob/">gob</a> package.</li> -<li><a href="/doc/articles/laws_of_reflection.html">The Laws of Reflection</a> - the fundamentals of the <a href="/pkg/reflect/">reflect</a> package.</li> -<li><a href="/doc/articles/image_package.html">The Go image package</a> - the fundamentals of the <a href="/pkg/image/">image</a> package.</li> -<li><a href="/doc/articles/image_draw.html">The Go image/draw package</a> - the fundamentals of the <a href="/pkg/image/draw/">image/draw</a> package.</li> +<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="/doc/articles/c_go_cgo.html">C? Go? Cgo!</a> - linking against C code with <a href="/cmd/cgo/">cgo</a>.</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="/doc/articles/godoc_documenting_go_code.html">Godoc: documenting Go code</a> - writing good documentation for <a href="/cmd/godoc/">godoc</a>.</li> -<li><a href="http://blog.golang.org/2011/06/profiling-go-programs.html">Profiling Go Programs</a></li> -<li><a href="/doc/articles/race_detector.html">Data Race Detector</a> - testing Go programs for race conditions.</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"/> -<p> -The talks marked with a red asterisk (<font color="red">*</font>) were written -before Go 1 and contain some examples that are no longer correct, but they are -still of value. -</p> - <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: @@ -158,63 +164,31 @@ interfaces, reflection, and concurrency. Builds a toy web crawler to demonstrate these. </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="meet_the_go_team"><a href="http://www.youtube.com/watch?v=sln-gJaURzk">Meet the Go team</a></h3> +<h3 id="go_code_that_grows"><a href="http://vimeo.com/53221560">Code that grows with grace</a></h3> <p> -A panel discussion with David Symonds, Robert Griesemer, Rob Pike, Ken Thompson, Andrew Gerrand, and Brad Fitzpatrick. +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="writing_web_apps"><a href="http://www.youtube.com/watch?v=-i0hat7pdpk">Writing Web Apps in Go</a><font color="red">*</font></h3> +<h3 id="go_concurrency_patterns"><a href="http://www.youtube.com/watch?v=f6kdp27TYZs">Go Concurrency Patterns</a></h3> <p> -A talk by Rob Pike and Andrew Gerrand presented at Google I/O 2011. -It walks through the construction and deployment of a simple web application -and unveils the <a href="http://blog.golang.org/2011/05/go-and-google-app-engine.html">Go runtime for App Engine</a>. -See the <a href="http://talks.golang.org/2011/Writing_Web_Apps_in_Go.pdf">presentation slides</a>. +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="go_programming"><a href="http://www.youtube.com/watch?v=jgVhBThJdXc">Go Programming</a><font color="red">*</font></h3> +<h3 id="advanced_go_concurrency_patterns"><a href="http://www.youtube.com/watch?v=QDDwwePbDtw">Advanced Go Concurrency Patterns</a></h3> <p> -A presentation delivered by Rob Pike and Russ Cox at Google I/O 2010. It -illustrates how programming in Go differs from other languages through a set of -examples demonstrating features particular to Go. These include concurrency, -embedded types, methods on any type, and program construction using interfaces. +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="http://code.google.com/p/go-wiki/wiki/GoTalks">GoTalks -page</a> at the <a href="http://code.google.com/p/go-wiki/wiki">Go Wiki</a> for -more Go talks. +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="http://code.google.com/p/go-wiki/wiki/NonEnglish">NonEnglish</a> page -at the <a href="http://code.google.com/p/go-wiki/wiki">Go Wiki</a> for localized +See the <a href="/wiki/NonEnglish">NonEnglish</a> page +at the <a href="/wiki">Wiki</a> for localized documentation. </p> - -<h2 id="community">The Go Community</h2> - -<img class="gopher" src="/doc/gopher/project.png"/> - -<h3 id="mailinglist"><a href="http://groups.google.com/group/golang-nuts">Go Nuts Mailing List</a></h3> -<p>The <a href="http://groups.google.com/group/golang-nuts">golang-nuts</a> -mailing list is for general Go discussion.</p> - -<h3 id="projects"><a href="http://code.google.com/p/go-wiki/wiki/Projects">Go Wiki Projects Page</a></h3> -<p>A list of external Go projects including programs and libraries.</p> - -<h3 id="irc"><a href="irc:irc.freenode.net/go-nuts">Go IRC Channel</a></h3> -<p><b>#go-nuts</b> on <b>irc.freenode.net</b> is the official Go IRC channel.</p> - -<h3 id="plus"><a href="https://plus.google.com/101406623878176903605/posts">The Go Programming Language at Google+</a></h3> -<p>The Go project's Google+ page.</p> - -<h3 id="twitter"><a href="http://twitter.com/go_nuts">@go_nuts at Twitter</a></h3> -<p>The Go project's official Twitter account.</p> |