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

rsc opened this issue Sep 3, 2020 · 2 comments

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

rsc opened this issue Sep 3, 2020 · 2 comments


Copy link

@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
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. 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 removed this from the Go1.16 milestone Sep 3, 2020
@rsc rsc added this to the Unreleased milestone Sep 3, 2020
Copy link

@stevetraut stevetraut commented Sep 3, 2020

The original file at 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 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. 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.

Copy link

@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, 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
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
4 participants