зеркало из https://github.com/golang/blog.git
content: add godoc.org-redirect.article
Change-Id: Ie552c0ecf4479958ed51be5d1981a8112bbb8982 Reviewed-on: https://go-review.googlesource.com/c/blog/+/277952 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Trust: Julie Qiu <julie@golang.org>
This commit is contained in:
Родитель
c68f4919b2
Коммит
211a3514fe
|
@ -0,0 +1,87 @@
|
|||
# Redirecting godoc.org requests to pkg.go.dev
|
||||
12:00 15 Dec 2020
|
||||
|
||||
Julie Qiu
|
||||
|
||||
##
|
||||
|
||||
With the introduction of Go modules and the growth of the Go ecosystem,
|
||||
[pkg.go.dev](https://pkg.go.dev) was
|
||||
[launched in 2019](https://blog.golang.org/go.dev) 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](https://blog.golang.org/pkg.go.dev-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](https://github.com/golang/go/milestone/157?closed=1)
|
||||
and [pkgsite/design-2020](https://github.com/golang/go/milestone/159?closed=1)
|
||||
milestones on the Go issue tracker. Your feedback resulted in support for
|
||||
popular feature requests on pkg.go.dev,
|
||||
[open sourcing pkgsite](https://blog.golang.org/pkgsite), and most recently, a
|
||||
[redesign of pkg.go.dev](https://blog.golang.org/pkgsite-redesign).
|
||||
|
||||
## 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](https://github.com/golang/go/milestone/157)
|
||||
is complete.
|
||||
|
||||
During this migration, updates will be posted to
|
||||
[Go issue 43178](https://golang.org/issue/43178).
|
||||
|
||||
We encourage everyone to begin using pkg.go.dev today. You can do so by
|
||||
visiting [godoc.org?redirect=on](https://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](http://go.googlesource.com/gddo) 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](https://golang.org/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](https://pkg.go.dev/badge) if you would like to
|
||||
update your badge link.
|
||||
|
||||
## Feedback
|
||||
|
||||
As always, feel free to [file an issue](https://golang.org/s/pkgsite-feedback)
|
||||
on the Go issue tracker for any feedback.
|
||||
|
||||
## Contributing
|
||||
|
||||
Pkg.go.dev is an [open source project](https://go.googlesource.com/pkgsite). If
|
||||
you’re interested in contributing to the pkgsite project, check out the
|
||||
[contribution guidelines](https://go.googlesource.com/pkgsite/+/refs/heads/master/CONTRIBUTING.md)
|
||||
or join the
|
||||
[#pkgsite channel](https://gophers.slack.com/messages/pkgsite) on Gophers Slack
|
||||
to learn more.
|
Загрузка…
Ссылка в новой задаче