介绍
在2019年,我们启动了go.dev,这是Go开发人员新的资源中心。
作为该站点的一部分,我们还启动了pkg.go.dev,它是有关Go软件包和模块的信息资源中心。像godoc.org一样 ,pkg.go.dev也提供Go文档功能。但是它懂go module,提供相关软件包以前版本的信息!
今年我们将在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问题跟踪器上发布(https://golang.org/s/discovery-feedback)。
-
电子邮件go-discovery-feedback@google.com。
- 在go.dev页脚中单击“共享反馈”或“报告问题”。
作为此过渡的一部分,我们还将讨论对pkg.go.dev进行API访问的计划 。我们将在Go issue 33654(https://golang.org/s/discovery-updates)上发布更新 。
FAQ
自11月推出以来,我们已经收到Go用户关于pkg.go.dev的大量反馈 。对于本文的其余部分,我们认为回答一些常见问题会有所帮助。
1.我的软件包未显示在pkg.go.dev上!如何添加?
我们会定期监视Go Module Index(https://index.golang.org/index)以查找要添加到pkg.go.dev的新软件包。如果在pkg.go.dev上没有看到软件包,则可以通过从proxy.golang.org获取模块版本来添加它 。有关说明,请参见 go.dev/about。
2. 我的软件包有许可证限制。它出什么问题了?
我们知道,无法在pkg.go.dev上完整地看到您想要的软件包,这是一个令人沮丧的经历。感谢您在我们改进许可证检测算法过程中的耐心配合。
自11月推出以来,我们进行了以下改进:
-
更新了我们的许可政策(https://pkg.go.dev/license-policy),里面包括我们检测和识别的许可列表
-
与许可证检查(https://github.com/google/licensecheck)团队合作,改改善对版权声明的检测
- 建立了特殊情况的手动审核流程
与往常一样,我们的许可政策位于 pkg.go.dev/license-policy。如果您遇到问题,请随时在Go问题跟踪器上提交问题(https://golang.org/x/discovery-feedback),或发送电子邮件至 go-discovery-feedback@google.com, 以便我们直接与您合作!
3. pkg.go.dev会开源吗,以便我可以在我的私人库上运行它?
我们知道,拥有私有代码库的公司希望运行提供模块支持的文档服务器。我们希望帮助满足这一需求,但是我们感到目前还不是很深入的了解这个痛点。
我们从用户那里听说,运行godoc.org服务器比实际上要复杂得多,因为它是为在Internet范围而不是仅在公司内部提供服务而设计的。我们认为当前的 pkg.go.dev服务将出现相同的问题。
我们认为使用新的服务都能够提供私有代码部署,而不是让每家公司都面临运行在公网上面。而且除了提供文档之外,新服务器还可以为goimports和 gopls提供帮助 。
如果要运行这样的服务,请填写此 3-5分钟的调查(https://google.qualtrics.com/jfe/form/SV_6FHmaLveae6d8Bn), 以帮助我们更好地了解您的需求。该调查将持续到2020年3月1日。
结论
我们对2020年pkg.go.dev的未来感到兴奋,希望您也是如此!我们期待听到您的反馈,并希望与Go社区在此过渡上合作。
有疑问加站长微信联系(非本文作者)