pkg.go.dev 的由来

1. pkg.go.dev 的未来规划

在 2019 年, Go 官方启动了名为 go.dev(https://go.dev) 的新域名, 这是面向 Go 开发人员的新 Hub。

作为该站点的一部分, 还启动了 pkg.go.dev, 这是有关 Go package 和 module 的文档中心, 旨在取代 http://godoc.org。在新的一年里, Go team 将不断优化 pkg.go.dev 的体验, 以提升开发者的开发效率。

1.1. 一分钟速读

1. 将 http://godoc.org 请求重定向到 pkg.go.dev, 并向社区开发者征求反馈意见
2. 回答了开发者比较关心的几个问题: 1. 在迁移过程中, 如果 package 没有显示在 pkg.go.dev 上, 可以通过从 http://proxy.golang.org 获取对应版本的 module 来添加; 2. 开发者的 package 突然出现不明的许可证限制 , 不要慌, 后面会优化证书检测算法;
3. pkg.go.dev 是否会开源? 很多公司想搭建自己的代码文档中心, 目前这个需求在征求意见可填官方的调查问卷: https://google.qualtrics.com/jfe/form/SV_6FHmaLveae6d8Bn

1.2. 以下是正文部分

1.2.1. 将 http://godoc.org 请求重定向到 pkg.go.dev

为了减少在过渡的过程中对用户的打扰, 我们计划在今年晚些时候将流量从 http://godoc.org 重定向到 pkg.go.dev 上。同时我们需要您的及时意见反馈, 以确保 pkg.go.dev 能够满足我们所有用户的需求。我们鼓励大家从今天开始使用 pkg.go.dev, 并提供反馈。

开发者可以通过以下渠道与我们分享反馈意见:

• Post on the Go issue tracker.
• Email go-discovery-feedback@google.com.
• Click “Share Feedback” or “Report an Issue” in the go.dev footer.

迁移过程中, 我们还将讨论提供 API 访问 pkg.go.dev 的 plan。可以阅读最新的 Go issue 33654 并参与讨论。

1.2.2. 常见问题解答

自 11 月推出以来, 我们收到了来自 Go 用户的有关 pkg.go.dev 的大量反馈。对于本文的其余部分, 我们将回答一些常见问题。

• 在迁移过程中, 如果 package 没有显示在 pkg.go.dev 上肿么办?

我们会定期扫描 Go Module Index, 以查找要添加到 pkg.go.dev 的新软件包。如果在 pkg.go.dev 上没有看到软件包, 则可以通过从 http://proxy.golang.org 获取相应版本的 module 来添加。有关说明, 请参见 go.dev/about。

• My package has license restrictions. What’s wrong with it?

开发者的 package 突然出现不明的许可证限制 , 不要慌, 后面会优化证书检测算法。

自 11 月上线以来, 我们已经针对该问题做了以下改进:

1. 更新了我们的许可政策, 以包括我们检测和识别的许可列表;
2. 与许可证检查团队合作, 改善对版权声明的检测;
3. 建立了特殊情况的人工审核流程

• pkg.go.dev 是否会开源? 很多公司想搭建自己的代码文档中心

我们知道很多公司想要搭建自己的代码文档中心, 但这不是我们团队的任务。我们从用户那里得知, 运行 http://godoc.org 服务器比预想的要复杂得多, 因为它是为在公共 Internet 范围而不是仅在公司内部提供服务。我们认为当前的 pkg.go.dev 服务器也可能遇到相同的问题。

我们认为正确的方式就是公司的私有代码结合 pkg.go.dev 服务而不是每个公司都去大家拿一套 pkg.go.dev 的服务(过于复杂, 因为除了提供文档中心之外, 还要提供 goimports 和 gopls 的能力)。

如果需要这样的服务, 请填写此 3-5 分钟的调查, 以帮助我们更好地了解您的需求。该调查将持续到 2020 年 3 月 1 日。问卷地址: https://google.qualtrics.com/jfe/form/SV_6FHmaLveae6d8Bn

我们对 2020 年 pkg.go.dev 的未来感到兴奋, 希望广大开发者也一样! 我们期待听到您的反馈, 并希望与 Go 社区在该迁移中紧密合作。

原文地址: https://blog.golang.org/pkg.go.