:::info 日期:2020 年 01 月 31 日
作者:Julie Qiu
原文链接:https://go.dev/blog/pkg.go.dev-2020 :::

介绍

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

作为网站的一部分,我们还推出了 pkg.go.dev,这是一个关于 Go 包和模块的信息中心。 与 godoc.org 一样,pkg.go.dev 提供 Go 文档。 但是,它也可以理解模块并具有有关包的过去版本的信息!

今年,我们将向 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 问题 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 问题跟踪器上提交问题,或发送电子邮件至 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 社区合作完成此过渡。