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: link to language spec #57047

Open
zosmac opened this issue Dec 2, 2022 · 2 comments
Open

x/website: link to language spec #57047

zosmac opened this issue Dec 2, 2022 · 2 comments
Labels
NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. website
Milestone

Comments

@zosmac
Copy link

zosmac commented Dec 2, 2022

What is the URL of the page with the issue?

https://go.dev

What is your user agent?

Safari 16.2

Screenshot

image

What did you do?

Looking for link to the Go Language Specification

What did you expect to see?

A link in the Docs menu to the Language Spec

What did you see instead?

The closest link is to the Go User Manual, a page with a lengthy list of fine documentation, but has the Language Spec listed far down.

Please add a link in the Docs menu directly to the Language Spec to improve workflow. Thank you.

@gopherbot gopherbot added this to the Unreleased milestone Dec 2, 2022
@seankhliao seankhliao changed the title x/website: x/website: link to language spec Dec 2, 2022
@aarzilli
Copy link
Contributor

aarzilli commented Dec 2, 2022

The documentation page seems to suffer from a form of recency bias. Things like the langauge tutorial, the style guide, the language specification, etc, that are important but old get pushed farther and farther down as newer things are added.

One reading from that page would learn about fuzzing and workspaces before slices. Maybe I just don't get the taxonomy.

For reference this is what it looked like in 2020: https://web.archive.org/web/20200616161505/https://golang.org/doc/

@prattmic prattmic added the NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. label Dec 5, 2022
@prattmic
Copy link
Member

prattmic commented Dec 5, 2022

cc @dmitshur @jamalc

@dle8 dle8 modified the milestones: Unreleased, website/later Dec 8, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. website
Projects
None yet
Development

No branches or pull requests

5 participants