tour: local tour instructions incomplete

[brianshumate]

Context: https://tour.golang.org/welcome/3

The instructions suggest that downloading and installing Go allows the user to run the tour locally, but they do not mention that Go Tour project must also be installed.

Perhaps suggesting installation of Go and Go Tour with a link to the Go Tour project README for their installation and execution instructions would be helpful for folks wanting to run the tour locally.

[adg]

Dupe of golang/go#15183, but I'll leave this open as the canonical bug.

There I wrote:

Maybe we should link to a wiki page that explains both approaches?

[retnuh]

The tour should definitely be updated to include the proper instructions for running locally. As is, it leaves a pretty bad "first time user" experience to have to go to StackOverflow or wherever to figure out how to do it. I imagine that a bunch of potential users will just bail at that point.

[jeffjen]

I wanted to add that while trying to write some instructions on setting up gotour locally, I got a 403 on the websocket connection.

I understand that running the gotour with host:port other then localhost is dangerous, but my workspace and tutorial is running in a VM.

here is the log message I got

bad websocket origin: http://localhost:8080

[tleb]

Just for those coming from search engines who get the same error message: you need to access http://127.0.0.1:3999 not http://localhost:3999 if you haven't change the -http option on gotour.

[brettgoulder]

I just got caught by this when trying to learn go.

The binary release doesn't seem to include gotour.

Here's what the binary produces:

~ /usr/local/go/bin/go tool
addr2line
api
asm
cgo
compile
cover
dist
doc
fix
link
nm
objdump
pack
pprof
trace
vet
yacc

 ~ /usr/local/go/bin/go version
go version go1.7.1 darwin/amd64

Installing the gotour package and running gotour resolved it.

[adg]

cc @broady

[robphoenix]

Is the underlying issue here resolved by the instructions added in this commit by @adg: 7671a9e ?
If so is it worth adding a link in https://tour.golang.org/welcome/3 to these instructions? I had a look at the Go wiki but these instructions aren't there. Copying them there would mean there would be two sources of info to keep updated, so I assume it's easier to link to the README here?
I can open a CL for this if I've not got the wrong end of the stick.

[retnuh]

I think adding a link is probably the way to go, but I'd like to point out that the README is confusing, too. It says to run go tool tour before you actually install it. It would make more sense to have the instructions to install it, and then run it, wouldn't it?

[robphoenix]

I think the instructions in the README are correct; If you install a binary release of Go, suggested first, then you can run go tool tour straight away, otherwise if Go has been installed from source you will need to go get it.

[retnuh]

Ah that would make sense. I probably did a brew install golang (or whatever) to install go, which would have built it from source.

[ALTree]

go tool tour has been removed from the toolchain and now the instructions at that page say 1) install go 2) go get the tour 3) run the binary; which seems clear enough to me (and more importantly there's no more confusion between using the go tool copy or the external repository).

Closing here.