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 spec doesn't point to latest version #50181

Closed
griesemer opened this issue Dec 15, 2021 · 3 comments
Closed

x/website: link to spec doesn't point to latest version #50181

griesemer opened this issue Dec 15, 2021 · 3 comments
Labels
FrozenDueToAge NeedsFix The path to resolution is known, but the work has not been done. release-blocker Soon This needs to be done soon. (regressions, serious bugs, outages)
Milestone

Comments

@griesemer
Copy link
Contributor

griesemer commented Dec 15, 2021

https://go.dev/ref/spec doesn't point to the latest (in progress version of the spec). While incomplete, the latest version has significant sections on generics. The beta is out, we should update this ASAP.

I'd expect to see the content that we show here: https://tip.golang.org/ref/spec.

@gopherbot gopherbot added this to the Unreleased milestone Dec 15, 2021
@griesemer griesemer added NeedsFix The path to resolution is known, but the work has not been done. Soon This needs to be done soon. (regressions, serious bugs, outages) labels Dec 15, 2021
@griesemer griesemer modified the milestones: Unreleased, Go1.18 Dec 15, 2021
@griesemer
Copy link
Contributor Author

Apparently we use the spec of the latest released version here (which is the Go 1.17 spec). But given that we show the first generics tutorial among the documentation, I think we should show the latest (in-progress) version of the spec as well. While the spec is incomplete, many new sections have been written which are complete and are relevant for understanding generics (e.g., new syntax, interfaces as type sets, and new rules for assignments and conversions).

@ianlancetaylor
Copy link
Contributor

I think for the next two months it's OK to point people to https://tip.golang.org/ref/spec.

@dmitshur
Copy link
Contributor

dmitshur commented Jan 26, 2022

I agree with Ian, and think this is working as intended.
https://go.dev/ref/spec allows users to view the specification for the currently stable Go language version.
https://tip.golang.org/ref/spec allows previewing upcoming changes, which might be evolving.
When the final Go 1.18 is released, the content at https://tip.golang.org/ref/spec will become visible at https://go.dev/ref/spec. This happens as part of the release process, so there's nothing we need to do explicitly to make it happen.

Blog posts and tutorials can link to https://tip.golang.org/ref/spec now, and that link can be simplified to "/ref/spec" after 1.18 is out.

I'll close this issue to help keep the list of 1.18 release-blocking issues actionable. @griesemer Please comment or re-open if you think there's something we need to do before 1.18 can be released.

@golang golang locked and limited conversation to collaborators Jan 26, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
FrozenDueToAge NeedsFix The path to resolution is known, but the work has not been done. release-blocker Soon This needs to be done soon. (regressions, serious bugs, outages)
Projects
None yet
Development

No branches or pull requests

4 participants