:::info 日期:2020 年 12 月 15 日
作者:Julie Qiu
原文链接:https://go.dev/blog/godoc.org-redirect :::

随着 Go 模块的引入和 Go 生态系统的发展,pkg.go.dev2019 年推出,为开发人员提供一个可以发现和评估 Go 包和模块的中心位置。 与 godoc.org 一样,pkg.go.dev 提供 Go 文档,但它也支持模块、更好的搜索功能以及帮助 Go 用户找到正确包的信号。

正如我们在 2020 年 1 月分享的那样,我们的目标是最终将来自 godoc.org 的流量重定向到 pkg.go.dev 上的相应页面。 我们还让用户可以选择将他们自己的请求从 godoc.org 重定向到 pkg.go.dev。

今年我们收到了很多很好的反馈,这些反馈已通过 Go 问题跟踪器上的 pkgsite/godoc.org-redirectpkgsite/design-2020 里程碑进行跟踪和解决。 您的反馈导致了对 pkg.go.dev、开源 pkgsite 以及最近对 pkg.go.dev 的重新设计的流行功能请求的支持。

下一步

此迁移的下一步是将所有来自 godoc.org 的请求重定向到 pkg.go.dev 上的相应页面。

这将在 2021 年初发生,在 pkgsite/godoc.org-redirect 里程碑中跟踪的工作完成之后。

在此迁移期间,更新将发布到 Go 问题 43178

我们鼓励每个人今天开始使用 pkg.go.dev。 您可以通过访问 godoc.org?redirect=on 或单击任何 godoc.org 页面右上角的“始终使用 pkg.go.dev”来实现。

常见问题

godoc.org URL 会继续有效吗?

是的! 我们会将所有到达 godoc.org 的请求重定向到 pkg.go.dev 上的等效页面,因此您的所有书签和链接将继续将您带到所需的文档。

golang/gddo 存储库会发生什么?

gddo 存储库将继续可供任何想要自己继续运行它,甚至 fork 和改进它的人使用。 我们会将其标记为存档,以表明我们将不再接受投稿。 但是,您将能够继续分叉存储库。

api.godoc.org 会继续运作吗?

此转换不会对 api.godoc.org 产生任何影响。 在 API 可用于 pkg.go.dev 之前,api.godoc.org 将继续为流量提供服务。 有关 pkg.go.dev 的 API 的更新,请参阅 Go 问题 36785

我的 godoc.org 徽章会继续有效吗?

是的! 徽章 URL 也将重定向到 pkg.go.dev 上的等效 URL。 您的页面将自动获得一个新的 pkg.go.dev 徽章。 如果您想更新您的徽章链接,您还可以在 pkg.go.dev/badge 上生成一个新徽章。

反馈

与往常一样,请随时在 Go 问题跟踪器上提交问题以获取任何反馈。

贡献

Pkg.go.dev 是一个开源项目。 如果您有兴趣为 pkgsite 项目做出贡献,请查看贡献指南或加入 Gophers Slack 上的 #pkgsite 频道以了解更多信息。