Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

x/website: doc/install: add download instructions into numbered steps #60941

Closed
varshneydevansh opened this issue Jun 22, 2023 · 5 comments
Closed

Comments

@varshneydevansh
Copy link

What is the URL of the page with the issue?

https://go.dev/doc/install#

What is your user agent?

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36

Screenshot

image

image

What did you do?

It's not an error but felt like a little inconsistent for someone if they are coming for the first time to download and install Golang.

If you are coming from the go.dev homepage, and you press the Download button, then it's landing you to the https://go.dev/dl/ which seems fine. Then, if you go to the installation instructions from that page, that also seems fine (Refer to the first Screenshot)

But, if you are coming from the https://go.dev/doc/ or directly hitting the link https://go.dev/doc/install# from the search engine page, then these instructions going to look a little confusing.

As, it's assuming we have already downloaded the Go binary release, as the first instruction starts with that.(Refer to the second Screenshot)

What did you expect to see?

My suggestion is that we modify the first line on the [https://go.dev/dl/] (https://go.dev/dl/) page to obtain the binary release suitable for your system, and then follow the installation instructions.

And for the users who are coming from the https://go.dev/doc/ or directly hitting the link https://go.dev/doc/install# from the search engine page, we can add the first instruction in the Go Installation as-

  1. Download the suitable binary release from the above button.(If you have already downloaded it, kindly move ahead with the following instructions)

Rest steps could remain the same.

It was the first time that I missed the very first thing, which was a download, as my focus went straight to the Go Installation. Although, I am doing installing binaries and programming for years, but I just felt it a little inconsistent from the perspective of a new user. As, I landed to https://go.dev/doc/install from an open-source contributing page. Particularly, the steps for installing on Linux.

@gopherbot gopherbot added this to the Unreleased milestone Jun 22, 2023
@seankhliao seankhliao changed the title x/pkgsite: go.dev/docs/install x/website: add download instructions into numbered steps Jun 22, 2023
@seankhliao seankhliao changed the title x/website: add download instructions into numbered steps x/website: doc/install: add download instructions into numbered steps Jun 22, 2023
@varshneydevansh
Copy link
Author

Hi @seankhliao,

Thank you for correcting the title and tag, as it is my first issue. If this seems like a valid inconsistency with the instructions, I would love to contribute to this issue.

Regards.

@varshneydevansh
Copy link
Author

Hi,

Is this the right place https://github.com/golang/website/tree/master/_content/doc/install to edit the doc/install page to add the required number step?

Do I have to edit the source.html file only?

@varshneydevansh
Copy link
Author

Hi @seankhliao I have opened a PR golang/website#229 for the numbered step instructions to eliminate the inconsistency.

@jamalc
Copy link

jamalc commented Jul 12, 2023

Thanks for highlighting this but we're currently redesigning the download and install flow internally.

@varshneydevansh
Copy link
Author

Hi @jamalc, So should I close the PR and this issue?

@golang golang locked and limited conversation to collaborators Jul 11, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

3 participants