Go 部落格

將 godoc.org 請求重定向到 pkg.go.dev

Julie Qiu
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 問題 43178。

我們鼓勵所有人從今天開始使用 pkg.go.dev。您可以透過訪問 godoc.org?redirect=on，或點選 godoc.org 頁面右上角的“始終使用 pkg.go.dev”來完成。

godoc.org 的 URL 還能繼續使用嗎？

是的！我們將 godoc.org 的所有請求重定向到 pkg.go.dev 上的等效頁面，因此您所有的書籤和連結將繼續帶您訪問所需的文件。

golang/gddo 倉庫會怎樣？

gddo 倉庫將繼續可用，供任何想自己執行或甚至分叉和改進它的人使用。我們將它標記為已歸檔，以明確表示我們不再接受貢獻。但是，您仍然可以繼續分叉該倉庫。

api.godoc.org 還能繼續使用嗎？

本次轉換不會影響 api.godoc.org。在 pkg.go.dev 提供 API 之前，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 頻道以瞭解更多資訊。