x/website: install instructions for macOS/Windows target .pkg/.msi downloads, but are not applicable for .tar.gz/.zip archives

[kevinburke1]

If I visit this URL: https://golang.org/doc/install?download=go1.15.2.darwin-amd64.tar.gz

I see instructions that read:

Open the package file you downloaded and follow the prompts to install Go.

The package installs the Go distribution to /usr/local/go. The package should put the /usr/local/go/bin directory in your PATH environment variable. You may need to restart any open Terminal sessions for the change to take effect.

This is incorrect for the tar.gz file, which when clicked on creates a "go" directory in the same parent directory as wherever the tarball was downloaded (usually ~/Downloads on a Mac).

We should probably instead instruct people to move the go folder to /usr/local or somewhere else on their PATH.

[toothrot]

/cc @dmitshur

[dmitshur]

Thanks for reporting. This seems to also apply to Windows. It's possible to select a zip (e.g., go1.15.2.windows-amd64.zip) at https://golang.org/dl/, but the https://golang.org/doc/install#install section on the redirected page begins with "Open the MSI file you downloaded ...".

It seems that the zip/tar.gz files are not taken into account on that page at this time.

/cc @stevetraut

[kevinburke1]

I'm happy to take a stab at fixing this, but note it is difficult to view/test changes locally because I get redirected from localhost:6060/doc/install to golang.org/dl.

I have a CL that makes it possible to view this page locally, which would make it easier to change. https://go-review.googlesource.com/c/website/+/254538