Go 博客

pkg.go.dev 的后续步骤

Julie Qiu
2020 年 1 月 31 日

引言

2019 年,我们推出了 go.dev,这是 Go 开发人员的新中心。

作为该网站的一部分,我们还推出了 pkg.go.dev,这是 Go 包和模块信息的中心来源。与 godoc.org 一样,pkg.go.dev 提供 Go 文档。但是,它还能理解模块,并包含有关包 past 版本的信息!

今年 throughout,我们将为 pkg.go.dev 添加功能,以帮助我们的用户更好地理解他们的依赖项,并帮助他们就导入哪些库做出更好的决策。

将 godoc.org 请求重定向到 pkg.go.dev

为了尽量减少有关使用哪个网站的混淆,今年晚些时候我们计划将 godoc.org 的流量重定向到 pkg.go.dev 上的相应页面。我们需要您的帮助,以确保 pkg.go.dev 满足我们所有用户的需求。我们鼓励大家今天就开始将 pkg.go.dev 用于所有需求,并提供反馈。

您的反馈将为我们的过渡计划提供信息,目标是使 pkg.go.dev 成为我们包和模块的主要信息和文档来源。我们确信您希望在 pkg.go.dev 上看到一些内容,我们希望听到您对这些功能的意见!

您可以通过以下渠道与我们分享您的反馈

作为此次过渡的一部分,我们还将讨论 pkg.go.dev 的 API 访问计划。我们将在 Go issue 33654 上发布更新。

常见问题解答

自 11 月推出以来,我们收到了 Go 用户关于 pkg.go.dev 的大量宝贵反馈。在本文的其余部分,我们认为回答一些常见问题会有所帮助。

我的包没有显示在 pkg.go.dev 上!如何添加?

我们定期监控 Go Module Index,以查找新包并将其添加到 pkg.go.dev。如果您在 pkg.go.dev 上没有看到某个包,可以通过从 proxy.golang.org 获取模块版本来添加它。有关说明,请参阅 go.dev/about

我的包有许可证限制。怎么了?

我们理解,在 pkg.go.dev 上无法完整地看到您想要的包可能会令人沮丧。感谢您的耐心等待,我们正在改进我们的许可证检测算法。

自 11 月推出以来,我们已进行了以下改进

  • 更新了我们的 许可证策略,其中包含我们检测和识别的许可证列表
  • licensecheck 团队合作,改进了版权声明的检测
  • 为特殊情况建立了手动审查流程

一如既往,我们的许可证策略可在 pkg.go.dev/license-policy 上查阅。如果您遇到问题,请随时在 Go issue tracker 上提交问题,或发送电子邮件至 go-discovery-feedback@google.com,以便我们与您直接合作!

pkg.go.dev 会开源吗,以便我可以在工作中使用它来处理我的私有代码?

我们理解拥有私有代码的公司希望运行一个提供模块支持的文档服务器。我们希望满足这一需求,但我们觉得我们尚未像需要的那样充分理解它。

我们收到用户反馈,说运行 godoc.org 服务器比应有的要复杂,因为它设计用于在公共互联网规模上提供服务,而不是仅在公司内部提供服务。我们认为当前的 pkg.go.dev 服务器也会遇到同样的问题。

我们认为,与让每家公司都面临运行互联网规模的 pkg.go.dev 代码库的复杂性相比,一个新服务器更有可能成为处理私有代码的正确解决方案。除了提供文档外,新服务器还可以为 goimportsgopls 提供信息。

如果您想运行这样的服务器,请填写此 3-5 分钟调查,以帮助我们更好地了解您的需求。此调查将于 2020 年 3 月 1 日结束。

我们对 pkg.go.dev 在 2020 年的未来感到兴奋,希望您也是!我们期待听到您的反馈,并在过渡过程中与 Go 社区合作。

下一篇文章:Go 1.14 发布
上一篇文章:Go 1.15 提案
博客索引