doc: cmd/go: some module docs are on swtch.com, not golang.org

lmyy7pcs  于 6个月前  发布在  Go
关注(0)|答案(5)|浏览(58)

请在提交问题之前回答以下问题。谢谢!

您正在使用的Go版本是什么(go version)?

golang.org今天

这个问题是否在最新版本中重现?

是的

您正在使用什么操作系统和处理器架构(go env)?

我认为这并不重要

您做了什么?

去了golang.org
如果可能的话,请提供一个重现错误的食谱。
完整的可运行程序很好。
play.golang.org上的链接是最好的。

您期望看到什么?

go编程语言的文档应该托管在golang.org上

您实际上看到了什么?

托管在swtch.com上的go模块文档

l7mqbcuq

l7mqbcuq1#

不清楚swtch.com上独有的内容是什么,以及为什么在golang.org上看不到。能否详细说明一下?

w8biq8rn

w8biq8rn2#

是的,但如果不详细说明所有内容,我无法解释。
我在https://golang.org/cmd/go/页面上遇到了一些链接,主要是指向swtch.com获取golang.org上没有的信息。就我个人而言,我更喜欢golang.org的文档是自包含的。
完全理解的话,这不是我的决定;只是想表达一下观点,即从.org指向.com以获取更多信息的影响并不好,理想情况下应该是自包含的。这并不是对swtch.com内容的反对意见。

mzmfm0qo

mzmfm0qo3#

我们不能合理地拒绝在golang.org上链接到其他任何网站。例如,https://golang.org/pkg/html/template/链接到rawgit.com,https://golang.org/pkg/archive/zip/链接到pkware.com。我相信还有很多其他例子。
话虽如此,是的,swtch.com上的vgo信息是针对Go的特定内容,可以合理地转移到golang.org。模块目前是一个实验性设施。让我们在接近1.12版本发布时再回顾一下这个问题。

ebdffaop

ebdffaop4#

是的,当然我指的是具体的文档,但应该指定。

最后我检查了一下,详细的汇编器文档是旧的计划9,我认为是在远程服务器上,但现在它正确地引用为背景在9p.io。

rseugnpd

rseugnpd5#

目前在cmd/go页面上有3个链接到https://research.swtch.com/

只有模块化代码布局严重依赖research.swtch.com的说法 -
目前,请参阅https://research.swtch.com/vgo-module以获取有关版本控制系统中的源代码如何Map到模块文件树的信息。
其他所有内容都只是指向research.swtch.com的补充材料。
@rsc - 你有没有计划将一些模块化代码布局部分移动到golang.org中?

相关问题