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 · 3 comments
Open

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

rsc opened this issue Sep 3, 2020 · 3 comments
Assignees
Labels
Documentation NeedsFix The path to resolution is known, but the work has not been done. website

Comments

@rsc
Copy link
Contributor

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 The path to resolution is known, but the work has not been done. 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

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
Contributor

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
@jamalc jamalc modified the milestones: Unreleased, website/unplanned Jun 15, 2022
@gopherbot
Copy link

Change https://go.dev/cl/424575 mentions this issue: _content/doc/install: add link to the minimum requirements wiki page

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation NeedsFix The path to resolution is known, but the work has not been done. website
Projects
None yet
Development

No branches or pull requests

5 participants