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

doc: cmd/go: some module docs are on, not #27220

wsc1 opened this issue Aug 25, 2018 · 5 comments

doc: cmd/go: some module docs are on, not #27220

wsc1 opened this issue Aug 25, 2018 · 5 comments


Copy link

@wsc1 wsc1 commented Aug 25, 2018

Please answer these questions before submitting your issue. Thanks!

What version of Go are you using (go version)? today

Does this issue reproduce with the latest release?


What operating system and processor architecture are you using (go env)?

I don't think it matters

What did you do?

went to
If possible, provide a recipe for reproducing the error.
A complete runnable program is good.
A link on is best.

What did you expect to see?

Documentation for the go programming language to be hosted on

What did you see instead?

Documentation for go modules hosted on

Copy link

@ALTree ALTree commented Aug 25, 2018

It's not clear what is it that is only available on and you'd like to see on Can you expand?

@ALTree ALTree changed the title documentation not self-contained doc: documentation not self-contained Aug 25, 2018
Copy link

@wsc1 wsc1 commented Aug 25, 2018

Yes, but I cannot elaborate it all without going through everything.

There are some links I came across, mostly in the page
which refer to for information not present on

To my taste, I would prefer docs be self contained.

With full understanding it's not up to me; just would like to express the opinion that
the implications of pointing to a .com from a .org for more info don't sit well, and would ideally be self-contained. nothing against the content of intended.

Copy link

@ianlancetaylor ianlancetaylor commented Aug 25, 2018

It's not reasonable for us to refuse to link to any other site from For example, links to links to I'm sure there are many other examples.

That said, yes, the vgo information on is Go-specific and could reasonably move to Modules are currently an experimental facility. Let's revisit this when we are closer to the 1.12 release.

@ianlancetaylor ianlancetaylor added this to the Go1.12 milestone Aug 25, 2018
@ianlancetaylor ianlancetaylor changed the title doc: documentation not self-contained doc: some module docs are on, not Aug 25, 2018
Copy link

@wsc1 wsc1 commented Aug 25, 2018

Yes of course I meant go specific documentation, but should have specified.

Last I checked, the detailed assembler docs were old plan9 and I think off-site, but now it appears correctly referenced as background at

Copy link

@agnivade agnivade commented Nov 15, 2018

There are currently 3 links to in the cmd/go page.

Only Modular code layout leans heavily on saying -

For now, see for information about how source code in version control systems is mapped to module file trees.

All others just have supplemental material ponting to

@rsc - Do you have plans to move some of the modular code layout section inside ?

@andybons andybons modified the milestones: Go1.12, Go1.13 Feb 12, 2019
@bcmills bcmills changed the title doc: some module docs are on, not doc: cmd/go: some module docs are on, not Apr 8, 2019
@andybons andybons modified the milestones: Go1.13, Go1.14 Jul 8, 2019
@rsc rsc modified the milestones: Go1.14, Backlog Oct 9, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
8 participants