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: revise download page (system requirements for stable/archived versions) #18554

Open
nathany opened this issue Jan 7, 2017 · 18 comments
Labels
help wanted NeedsFix The path to resolution is known, but the work has not been done.
Milestone

Comments

@nathany
Copy link
Contributor

nathany commented Jan 7, 2017

"the official 1.4 download doesn't work on Macs. You need to use the special 1.4 download link on the build-from-source page. It would be nice if either the official 1.4 download were updated, or if another one were added with an annotation on the downloads page." - @robpike #18545 (comment)

related issue: #16352

@nathany
Copy link
Contributor Author

nathany commented Jan 7, 2017

Should Go 1.4-bootstrap be added under "Stable versions" so it is visible without scanning through the archived versions?

Perhaps the download page should also say something about macOS Sierra requiring Go 1.7 or better or Go 1.4-bootstrap?

@josharian josharian changed the title link Go 1.4-bootstrap from the download page website: link to Go 1.4-bootstrap from /dl/ Jan 7, 2017
@rakyll rakyll added this to the Go1.9Maybe milestone Jan 9, 2017
@ALTree
Copy link
Member

ALTree commented Jun 1, 2017

I don't think a prominent link to go1.4-bootstrap and/or notes about Sierra-bootstrapping requiring a specific version are things that belong in our main download page.

The only reason you might want to download go1.4 is for bootstrapping on a system for which we don't distribute binaries; and for this reason links to go1.4-bootstrap should stay in the 'compiling-from-source' doc page, and only there.

@ALTree ALTree added the NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. label Jun 1, 2017
@nathany
Copy link
Contributor Author

nathany commented Jun 19, 2017

The only reason you might want to download go1.4 is for bootstrapping on a system for which we don't distribute binaries; and for this reason links to go1.4-bootstrap should stay in the 'compiling-from-source' doc page, and only there.

Makes sense to me.

Currently the featured downloads indicate system requirements, such as "OS X 10.8 or later".

featured

Perhaps the tables below for stable and archived version should also include system requirements, including an upper bound if applicable.

e.g. go1.7.6.darwin-amd64.pkg could say macOS 10.8 to 10.11 -- to address the issue that it won't work on newer versions of macOS

Also, some older versions of Go may work on older operating systems -- which may be useful information for some people.

@nathany
Copy link
Contributor Author

nathany commented Jun 19, 2017

A few other minor revisions to the download page:

  • "Apple macOS" instead of OS X, as it was renamed. I've heard this even applies to past versions, though I haven't been able to verify that.
  • "Intel/AMD" or "x86" 64-bit processor instead of only Intel

@nathany nathany changed the title website: link to Go 1.4-bootstrap from /dl/ website: revise download page (system requirements for stable/archived versions) Jun 19, 2017
@ALTree
Copy link
Member

ALTree commented Jun 20, 2017

This two

  • OS X -> macOS (the official name was changed)
  • reword "Intel 64-bit" since it looks like we want an Intel processor (but we just want x86)

seems reasonable. You'll still need @broady approval, I think.

@ALTree
Copy link
Member

ALTree commented Jun 20, 2017

Perhaps the tables below for stable and archived version should also include system requirements, including an upper bound if applicable

I don't see how we could add this information to that table without cluttering it, though. It's already quite packed and some of the requirements are much more wordy to write down that the OSX ones.

@bradfitz
Copy link
Contributor

@broady, feel free to move this to Unreleased or Go 1.10 as you'd like.

@nathany
Copy link
Contributor Author

nathany commented Jul 29, 2017

Sorry for not contributing these minor changes yet.

Are they tied to the release cycle?

@bradfitz
Copy link
Contributor

@nathany, currently. There's a long-running desire to decouple Go release branches from the website (the website runs off the release's godoc binary), but that hasn't happened.

So this is probably out of scope for Go 1.9 at this point.

@bradfitz bradfitz modified the milestones: Go1.10, Go1.9Maybe Jul 30, 2017
@bradfitz bradfitz added the NeedsFix The path to resolution is known, but the work has not been done. label Jul 30, 2017
@gopherbot gopherbot removed the NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. label Jul 30, 2017
@StudioEtrange
Copy link

StudioEtrange commented Nov 9, 2017

Still need a "real" binary release of 1.4.4, for some packaging system, some fast bootstraping purpose (without having to build go 1.4.4), or use gonative+gox tools on macos, and so on.

I dont know which problem does it generate to make a binary release instead of just source release ?
Is it a decision based only on some guess of what people needs ?

Please just release a binary go1.4.4 !

@PaulReiber
Copy link

PaulReiber commented Nov 9, 2017 via email

@broady
Copy link
Member

broady commented Nov 9, 2017

@StudioEtrange @PaulReiber
Please, move that discussion back to Issue #16352.

@StudioEtrange
Copy link

...this isn't as easy as a push of a button? Seriously? ...that's so 20th
century...

I take your point as ironic.
I think/know there is a whole validation process, unit test and on so on in play. And even if it's not simple, I guess the whole process is automatized in some ways.

But i still dont know why the decision to not take this path have been taken.

As I read comments here and on issue #16352, people first talking about making a release. And not clear why it has been stopped.

Only

The only reason you might want to download go1.4 is for bootstrapping on a system for which we don't distribute binaries; and for this reason links to go1.4-bootstrap should stay in the 'compiling-from-source' doc page, and only there.

And this a kind of guess of use case of what people needs.
My point is that it's better to make a release (if the release and publication chain works without too many hassle) without guessing all the possibility user will find by itself

@nathany
Copy link
Contributor Author

nathany commented Nov 30, 2017

FreeBSD system requirements are changing:
https://golang.org/cl/64910/

The download page doesn’t have requirements for BSD at all.

@nathany
Copy link
Contributor Author

nathany commented Nov 30, 2017

Related issue #10147

@bradfitz
Copy link
Contributor

@nathany, the install.html was already updated to say "FreeBSD 10.3 or later" in the e76ae8a you linked to.

And the top of the https://golang.org/dl/ says:

After downloading a binary release suitable for your system, please follow the installation instructions.

... which links to https://tip.golang.org/doc/install , which says:

FreeBSD 10.3 or later

So the information isn't entirely absent. We just don't have a huge bubble for downloading FreeBSD like we do for the top 3 OSes. I think that's fine. Very few if any FreeBSD users will be using 9.3.

@nathany
Copy link
Contributor Author

nathany commented Dec 7, 2017

So the requirements are on https://tip.golang.org/doc/install but not https://tip.golang.org/dl/. Might not be the most intuitive since the download page tends to come first.

Also related: #23011

Go 1.10 is the last release that will run on OS X [sic] 10.8 Mountain Lion. Go 1.11 will require OS X [sic] 10.9 Mavericks or later.

@nathany
Copy link
Contributor Author

nathany commented Dec 8, 2017

Maybe a more substantial redesign of those pages will come along with #18580 (homebrew/chocolatey) or golang/cwg#11 (golang.org).

Whether or not it makes sense to suggest older version of Go to people on older operating systems, I don't know. It just seems like the giant list of archived Go versions could be more useful if system requirements were for each Go version.

@ianlancetaylor ianlancetaylor removed this from the Go1.10 milestone Feb 17, 2018
@ianlancetaylor ianlancetaylor added this to the Go1.10.1 milestone Feb 17, 2018
@andybons andybons modified the milestones: Go1.10.1, Unplanned Mar 27, 2018
@dmitshur dmitshur changed the title website: revise download page (system requirements for stable/archived versions) x/website: revise download page (system requirements for stable/archived versions) Dec 9, 2020
@seankhliao seankhliao modified the milestones: Unplanned, Unreleased Aug 20, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted NeedsFix The path to resolution is known, but the work has not been done.
Projects
None yet
Development

No branches or pull requests