You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Next, make the directories src/github.com/_user/hello inside your workspace (if you use GitHub, substitute your _user name for user),
The following would be better:
Next, make the directories src/github.com/user/_try-golang/hello inside your workspace (if you use GitHub, substitute your _GitHub user name for user),
(The bolding is just for emphasis in this issue.)
The new text aids novice Go users, in two ways:
Novices will wonder where their GitHub repo names fit in the pattern. This will slow them down, and be frustrating. The new text supplies the answer (try-golang, in this case).
"User name" seems (in effect) ambiguous here.
Novice Go users (by definition) are unfamiliar with the semantics of Go's workspace directory structure. For them (as well as generally, outside Go), the most commonly used context for the term "user name" is OS X, Linux or Windows—not GitHub.
Likely they'd assume the former (as I did). They can figure it out, but why include this stumbling block in the first place?
The new text specifies it means the GitHub user name.
This change aims to help smooth the path, for new Go language users.
What version of Go are you using (go version)? N/A
What operating system and processor architecture are you using (go env)? N/A
What did you do? N/A
What did you expect to see? N/A
What did you see instead? N/A
The text was updated successfully, but these errors were encountered:
bradfitz
changed the title
In 'hello world', include GitHub repo and clarify user name
website: In 'hello world', include GitHub repo and clarify user name
Aug 3, 2016
That section has been rewritten for go1.8 after the introduction of default GOPATH, and there's now no reference to github.com/usr paths
Create your workspace directory, $HOME/go. (If you'd like to use a different directory, you will need to set the GOPATH environment variable; see How to Write Go Code for details.)
Next, make the directory src/hello inside your workspace, and in that directory create a file named hello.go that looks like:
Documentation webpage Getting Started—in section Test your installation—currently says:
The following would be better:
(The bolding is just for emphasis in this issue.)
The new text aids novice Go users, in two ways:
try-golang
, in this case).Novice Go users (by definition) are unfamiliar with the semantics of Go's workspace directory structure. For them (as well as generally, outside Go), the most commonly used context for the term "user name" is OS X, Linux or Windows—not GitHub.
Likely they'd assume the former (as I did). They can figure it out, but why include this stumbling block in the first place?
The new text specifies it means the GitHub user name.
This change aims to help smooth the path, for new Go language users.
go version
)? N/Ago env
)? N/AThe text was updated successfully, but these errors were encountered: