Skip to content

x/website: better documentation for writing v2+ go modules #59772

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.

Sign up for GitHub

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

Jump to bottom
Closed
mcandre opened this issue Apr 22, 2023 · 3 comments
Closed

x/website: better documentation for writing v2+ go modules #59772

mcandre opened this issue Apr 22, 2023 · 3 comments
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge modules WaitingForInfo Issue is not actionable because of missing required information, which needs to be provided. website
Milestone
website/backlog

Comments

@mcandre
Copy link

mcandre commented Apr 22, 2023

I still don't understand how we're expected to write post-v1.x series go modules. The current go install behavior is confusing and the current documentation is quite sparse.

Ideally, v0 and v2 would behave identically in the go mod system. But I'd settle at least for clearer documentation.
@gopherbot gopherbot added the Documentation Issues describing a change to documentation. label Apr 22, 2023
@gophun
Copy link

gophun commented Apr 22, 2023

It would probably help if you pointed out at which point in the text of the existing documentation you got stuck.

https://go.dev/doc/modules/release-workflow#breaking
https://go.dev/doc/modules/major-version

@mvdan mvdan added the WaitingForInfo Issue is not actionable because of missing required information, which needs to be provided. label Apr 22, 2023
@seankhliao seankhliao changed the title better documentation for writing v2+ go modules x/website: better documentation for writing v2+ go modules Apr 22, 2023
@gopherbot gopherbot added this to the Unreleased milestone Apr 22, 2023
@thediveo
Copy link
Contributor

one thing that is intuitive only after some trial and error is that @latest doesn't go for v2 unless you specify /v2. Maybe the OP thinks of this?

@jamalc jamalc modified the milestones: Unreleased, website/later Apr 28, 2023
@mvdan
Copy link
Member

mvdan commented May 4, 2023

Two weeks without a clarifying reply, and it's not the first time, so I'm closing this for now.

@mvdan mvdan closed this as not planned Won't fix, can't repro, duplicate, stale May 4, 2023
@golang golang locked and limited conversation to collaborators May 3, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Assignees
No one assigned
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge modules WaitingForInfo Issue is not actionable because of missing required information, which needs to be provided. website
Projects
None yet
Milestone
website/backlog
Development

No branches or pull requests
7 participants
@mcandre @mvdan @bcmills @thediveo @gopherbot @jamalc @gophun