The Go Blog

By Julie Qiu 15 December 2020

Julie Qiu
15 December 2020

With the introduction of Go modules and the growth of the Go ecosystem, pkg.go.dev was launched in 2019 to provide a central place where developers can discover and evaluate Go packages and modules. Like godoc.org, pkg.go.dev serves Go documentation, but it also supports modules, better search functionality, and signals to help Go users to find the right packages.

As we shared in January 2020, our goal is to eventually redirect traffic from godoc.org to the corresponding page on pkg.go.dev. We’ve also made it possible for users to opt in to redirecting their own requests from godoc.org to pkg.go.dev.

We’ve received a lot of great feedback this year, which has been tracked and resolved through the pkgsite/godoc.org-redirect and pkgsite/design-2020 milestones on the Go issue tracker. Your feedback resulted in support for popular feature requests on pkg.go.dev, open sourcing pkgsite, and most recently, a redesign of pkg.go.dev.

Next Steps

The next step in this migration is to redirect all requests from godoc.org to the corresponding page on pkg.go.dev.

This will happen in early 2021, once the work tracked at the pkgsite/godoc.org-redirect milestone is complete.

During this migration, updates will be posted to Go issue 43178.

We encourage everyone to begin using pkg.go.dev today. You can do so by visiting godoc.org?redirect=on, or clicking “Always use pkg.go.dev” in the top right corner of any godoc.org page.

FAQs

Will godoc.org URLs continue to work?

Yes! We will redirect all requests arriving at godoc.org to the equivalent page on pkg.go.dev, so all your bookmarks and links will continue to take you to the documentation you need.

What will happen to the golang/gddo repository?

The gddo repository will remain available for anyone who wants to keep running it themselves, or even fork and improve it. We will mark it archived to make clear that we will no longer accept contributions. However, you will be able to continue forking the repository.

Will api.godoc.org continue to work?

This transition will have no impact on api.godoc.org. Until an API is available for pkg.go.dev, api.godoc.org will continue to serve traffic. See Go issue 36785 for updates on an API for pkg.go.dev.

Will my godoc.org badges keep working?

Yes! Badge URLs will redirect to the equivalent URL on pkg.go.dev too. Your page will automatically get a new pkg.go.dev badge. You can also generate a new badge at pkg.go.dev/badge if you would like to update your badge link.

Feedback

As always, feel free to file an issue on the Go issue tracker for any feedback.

Contributing

Pkg.go.dev is an open source project. If you’re interested in contributing to the pkgsite project, check out the contribution guidelines or join the #pkgsite channel on Gophers Slack to learn more.