所有 godoc.org 的请求将转移到 pkg.go.dev
朱莉-邱
2020年12月15日
随着 Go 模块的引入和 Go 生态系统的发展,pkg.go.dev于2019年推出,为开发者提供一个可以发现和评估 Go 包和模块的中心场所。与 godoc.org 一样,pkg.go.dev 也为 Go 文档服务,但它也支持模块、更好的搜索功能,以及帮助 Go 用户找到正确的软件包的信号。
正如我们在2020年1月分享的,我们的目标是最终将 godoc.org 的流量重定向到 pkg.go.dev 的相应页面上。我们也让用户有可能选择将他们自己的请求从 godoc.org 重定向到 pkg.go.dev。
今年我们收到了很多很好的反馈,这些反馈已经通过Go问题跟踪器上的pkgsite/godoc.org-redirect和pkgsite/design-2020里程碑进行跟踪和解决。你的反馈导致了对pkg.go.dev上流行的功能请求的支持,开源pkgsite,以及最近的重新设计pkg.go.dev。
接下来的步骤
这次迁移的下一步是将所有来自 godoc.org 的请求重定向到 pkg.go.dev 上的相应页面。
这将在2021年初发生,一旦pkgsite/godoc.org-redirect 里程碑中跟踪的工作完成。
在这次迁移中,更新将被发布到Go issue 43178。
我们鼓励大家今天就开始使用 pkg.go.dev。你可以通过访问godoc.org?redirect=on,或在任何 godoc.org 页面的右上角点击 「Always use pkg.go.dev」来这样做。
FAQs
godoc.org的URL会继续工作吗?
是的!是的!我们将重新定向所有进入 godoc.org 的请求。我们将把所有到达 godoc.org 的请求重定向到 pkg.go.dev 的相应页面,所以你所有的书签和链接将继续带你到你需要的文档。
golang/gddo资源库将发生什么变化?
gddo 仓库将继续提供给任何想继续运行它的人,甚至是分叉和改进它。我们会把它归档,以表明我们不再接受贡献。但是,你可以继续克隆这个仓库。
api.godoc.org还能继续工作吗?
这次过渡对 api.godoc.org 没有影响。在为 pkg.go.dev 提供 API 之前,api.godoc.org 将继续提供流量。请参阅Go issue 36785了解关于 pkg.go.dev的 API 的更新。
我的godoc.org徽章还能继续使用吗?
是的!徽章的 URL 也会重定向到 pkg.go.dev 的相应 URL 上。你的页面将自动获得一个新的pkg.go.dev 徽章。如果你想更新你的徽章链接,你也可以在pkg.go.dev/badge 上生成一个新的徽章。
反馈
像往常一样,如果有任何反馈,请随时在Go问题跟踪器上提交问题。
贡献
Pkg.go.dev是一个开放源代码项目。如果你对pkgsite 项目的贡献感兴趣,请查看贡献指南或加入Gophers Slack 的#pkgsite频道以了解更多。
本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
推荐文章: