Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.Sign up
cmd/go: document version tagging for modules not at the repo root #36014
What version of Go are you using (
This is valid. Modules within a repository are versioned independently. That means there needs to be a namespace of tags for each module. We accomplish that with a
Agreed. I'm working on module reference documentation for 1.14 (#33637), which will include that. It will be linked from https://golang.org/doc. I expect that will supercede a lot of information in
I don't expect everyone will immediately reach for reference documentation though, since it will be long and verbose. Where would you look for this information? Would a blog post or similar article help?
Unfortunately, we can't mix those namespaces. Version tags should be permanent. If version tags are added for the root module later, they can't change the meaning for versions of non-root modules.
Yes, a blog post or article would definitely help. When researching this issue, I ended op on the Multi-Module Repositories section of FAQ. I see now that I missed this line on my initial read:
So the information is there, but it's quite easy to miss.
Also, I'm not sure if this is possible, but it might be nice if