pkg.go.dev 的下一步计划
邱丽仪
2020年1月31日
介绍
在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上看到一些东西,并且希望您能收到有关这些功能的信息!
您可以通过以下渠道与我们分享您的反馈意见:
- 在问题追踪器上发布。
- 电子邮件go-discovery-feedback@google.com。
- 在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问题跟踪器上提交问题或发送电子邮件至go-discovery-feedback@google.com我们可以直接与您合作!
pkg.go.dev是否会开源,以便我可以在我的私人代码上运行它?
我们知道,拥有私有代码的公司希望运行提供模块支持的文档服务器。我们想帮助满足这一需求,但我们认为我们对此的了解不如我们所需要。
我们从用户那里得知,运行godoc.org服务器比应该的要复杂得多,因为它是为在公共Internet范围而不是仅在公司内部提供服务而设计的。我们认为当前的pkg.go.dev服务器将出现相同的问题。
我们认为,新服务器更可能是与私有代码一起使用的正确答案,而不是使每个公司都面临运行互联网规模的复杂性pkg.go.dev代码库。除了提供文档外,新服务器还可以将信息提供给goimports和gopls。
如果您要运行这样的服务器,请填写此3-5分钟调查以帮助我们更好地了解您的需求。该调查将持续到2020年3月1日。
对于2020年pkg.go.dev的未来,我们感到很兴奋,希望您也一样!我们期待听到您的反馈,并希望与Go社区在此过渡上合作。
本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
推荐文章: