Skip to content

doc: outdated assessment of ARCHs maturity in "Installing Go from source" list #35009

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

Closed
ALTree opened this issue Oct 19, 2019 · 1 comment
Closed
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge NeedsFix The path to resolution is known, but the work has not been done.
Milestone

Comments

@ALTree
Copy link
Member

ALTree commented Oct 19, 2019

The Installing Go from source document contains, in the introduction section, a list of supported architectures. It says:

The Go compilers support nine instruction sets. There are important differences in the quality of the compilers for the different architectures.

The assessment of the various ports' "maturity grade" is outdated and somewhat misleading. A few issues:

  • s390x is listed as "new" and "not as well exercised as other ports."; but in reality is probably one of the ports that receive the most attention.
  • the arm64 port is mature, but it is listed as "not as well exercised as other ports"; it also says "New in 1.5", it seems unnecessary to note the newness of something that is 4 years old.
  • for 386 it says "Comparable to the amd64 port" (which is the most mature one), but in reality 386 is probably much less exercised than ports like arm / arm64 / s390x.
  • In general, the point of the list is not to present a chronological history of new ports, but to help the reader assess the newness and maturity of the archs. For this reason, mentioning that mips64 is "New in 1.6" is not useful (at this point, anything introduced in 1.6 is quite old).

I suggest we update the list to reflect the current status of the various ports. I'll send a CL.

@ALTree ALTree added the Documentation Issues describing a change to documentation. label Oct 19, 2019
@gopherbot
Copy link
Contributor

Change https://golang.org/cl/202197 mentions this issue: doc: update ports list description to reflect current status

@dmitshur dmitshur added this to the Go1.14 milestone Oct 21, 2019
@dmitshur dmitshur added the NeedsFix The path to resolution is known, but the work has not been done. label Oct 21, 2019
@golang golang locked and limited conversation to collaborators Nov 1, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge NeedsFix The path to resolution is known, but the work has not been done.
Projects
None yet
Development

No branches or pull requests

3 participants