From 7115eef6beb4f359245d2770bc6b4c6aa0ae25e1 Mon Sep 17 00:00:00 2001 From: Rob Pike Date: Mon, 14 Feb 2011 11:25:00 -0800 Subject: [PATCH] tutorial: rework the introduction to give "Effective Go" prominence and downplay the course notes. R=golang-dev, gri, rsc CC=golang-dev https://golang.org/cl/4190041 --- doc/go_tutorial.html | 19 +++++++++++-------- doc/go_tutorial.txt | 9 ++++++--- 2 files changed, 17 insertions(+), 11 deletions(-) diff --git a/doc/go_tutorial.html b/doc/go_tutorial.html index ece22036ae6..e3d946f8d04 100644 --- a/doc/go_tutorial.html +++ b/doc/go_tutorial.html @@ -5,10 +5,13 @@ This document is a tutorial introduction to the basics of the Go programming language, intended for programmers familiar with C or C++. It is not a comprehensive guide to the language; at the moment the document closest to that is the language specification. -After you've read this tutorial, you might want to look at +After you've read this tutorial, you should look at Effective Go, -which digs deeper into how the language is used. -Also, slides from a 3-day course about Go are available: +which digs deeper into how the language is used and +talks about the style and idioms of programming in Go. +Also, slides from a 3-day course about Go are available. +Although they're badly out of date, they provide some +background and a lot of examples: Day 1, Day 2, Day 3. @@ -258,11 +261,11 @@ of course you can change a string variable simply by reassigning it. This snippet from strings.go is legal code: 

 
-11        s := "hello"
-12        if s[1] != 'e' { os.Exit(1) }
-13        s = "good bye"
-14        var p *string = &s
-15        *p = "ciao"
+10        s := "hello"
+11        if s[1] != 'e' { os.Exit(1) }
+12        s = "good bye"
+13        var p *string = &s
+14        *p = "ciao"

However the following statements are illegal because they would modify diff --git a/doc/go_tutorial.txt b/doc/go_tutorial.txt index 5eea3c980bb..2b2a0cda1e6 100644 --- a/doc/go_tutorial.txt +++ b/doc/go_tutorial.txt @@ -6,10 +6,13 @@ This document is a tutorial introduction to the basics of the Go programming language, intended for programmers familiar with C or C++. It is not a comprehensive guide to the language; at the moment the document closest to that is the language specification. -After you've read this tutorial, you might want to look at +After you've read this tutorial, you should look at Effective Go, -which digs deeper into how the language is used. -Also, slides from a 3-day course about Go are available: +which digs deeper into how the language is used and +talks about the style and idioms of programming in Go. +Also, slides from a 3-day course about Go are available. +Although they're badly out of date, they provide some +background and a lot of examples: Day 1, Day 2, Day 3.