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: make supported OS versions easier to find #41212

Open
rsc opened this issue Sep 3, 2020 · 2 comments
Open

x/website: make supported OS versions easier to find #41212

rsc opened this issue Sep 3, 2020 · 2 comments
Assignees
Milestone

Comments

@rsc
Copy link
Contributor

@rsc rsc commented Sep 3, 2020

I spent a long time just now trying to identify which versions of Go support which operating system versions.
I thought this used to be documented on the install page.
All I can find is the text inside the "featured download" buttons on https://golang.org/dl/.
That can't be the only source for this info.
FreeBSD is a first-class port but not a featured download.
What version of FreeBSD do we support?
I can't find out.

https://golang.org/doc/install/source links back to /doc/install for "overall system requirements".

It is possible that the recent install page rewrite is what dropped the info, and we need to bring it back one way or another.

@rsc rsc added the NeedsFix label Sep 3, 2020
@rsc rsc added this to the Go1.16 milestone Sep 3, 2020
@rsc rsc modified the milestones: Go1.16, Unreleased Sep 3, 2020
@stevetraut
Copy link

@stevetraut stevetraut commented Sep 3, 2020

The original file at https://golang.org/doc/install had the information below under "System Requirements". It did not map every Go version to every OS version on which that Go was supported.

I can create a new file at https://golang.org/doc/system-requirements and add it to the website repo. We'll need to cobble together the Go version-to-OS-version mapping to add there -- I don't see that doc'ed anywhere. https://golang.org/dl/ appears to be as close as we get, and that doesn't list OS versions (just OSes).

I'll keep hunting for a full mapping. Or if we had it, it might have been removed.


Operating system Architectures Notes
FreeBSD 10.3 or later amd64, 386 Debian GNU/kFreeBSD not supported
Linux 2.6.23 or later with glibc amd64, 386, arm, arm64,s390x, ppc64le CentOS/RHEL 5.x not supported.Install from source for other libc.
macOS 10.11 or later amd64 use the clang or gcc† that comes with Xcode‡ for cgo support
Windows 7, Server 2008R2 or later amd64, 386 use MinGW (386) or MinGW-W64 (amd64) gcc†.No need for cygwin or msys.
@dmitshur
Copy link
Member

@dmitshur dmitshur commented Sep 3, 2020

This is a valid issue that we've been aware of for some time. I thought we already had an open issue tracking this, but after looking, I can't find it. So let's use this one.

The best currently available sources of information I'm aware of, which require a lot of mental mapping and reading that we wanted to consolidate on one clear page, include:

There's also a wiki page https://golang.org/wiki/MinimumRequirements, but I don't know how well maintained that is.

/cc @andybons @cagedmantis @toothrot

@dmitshur dmitshur changed the title doc: make supported OS versions easier to find x/website: make supported OS versions easier to find Sep 3, 2020
@stevetraut stevetraut self-assigned this Sep 8, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
4 participants
You can’t perform that action at this time.