Skip to content

x/website: improve downloads page #10147

@adg

Description

@adg

The current downloads page leaves a lot to be desired. It provides an overwhelming amount of information, but not the essential pieces.

Ideally it should be the single page a user needs to visit to set up a working Go tool chain.

Here's my proposed download page flow:

  • Step 1: on page load

Show a set of radio buttons for the user to select their OS/ARCH combination:
(Use the User-Agent HTTP header to detect the relevant OS/Arch combination and
pre-select it.)

    Operating System        Processor Architecture
    [ ] Windows             [ ] 64-bit x86 (amd64)
    [ ] Mac OS X (darwin)   [ ] 32-bit x86 (386)
    [ ] Linux
    [ ] FreeBSD

                    [ Download ]
  • Step 2: the file is downloading

When they click Download, replace the os/arch form with an installation message:

    You are now downloading go1.4.linux-amd64.tar.gz.
    (If the download does not start automatically, [click here].)

    Once you have downloaded the archive, you should install it:

            $ sudo tar -C /usr/local -xzf go1.4.linux-amd64.tar.gz

    Add `/usr/local/go/bin` to your `PATH` environment variable,
    and set the `GOPATH` environment variable to a suitable location 
    (NOT the installation path; see [this document] for more about GOPATH).

(With different variations for OS X, Windows, etc.)

Obviously we'll need some finessing on the messaging around GOPATH, but the central idea is hiding all the irrelevant options and providing basic installation instructions.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions