Go 部落格

下一步 pkg.go.dev

Julie Qiu
2020 年 1 月 31 日

簡介

在 2019 年，我們推出了 go.dev，這是 Go 開發人員的新中心。

我們也與此網站同時推出了 pkg.go.dev，它提供有關 Go 封包和模組資訊的集中來源。與 godoc.org 相同，pkg.go.dev 提供 Go 說明文件。不過，它也能辨識模組，並擁有過去版本的封包資訊！

在今年，我們將為 pkg.go.dev 加入更多功能，以幫助我們的使用者更了解他們所依賴的資訊，並讓他們在要匯入哪些函式庫時做出更好的決定。

將 godoc.org 要求重新導向到 pkg.go.dev

為了將使用哪個網站的混淆情況降到最低，我們計劃在今年稍晚時，將 godoc.org 傳來的流量重新導向到 pkg.go.dev 中對應的頁面。我們需要您的協助，以確保 pkg.go.dev 能滿足我們所有使用者的需求。我們鼓勵所有人從今天開始，在他們的所有需求中使用 pkg.go.dev，並提供回饋意見。

您的回饋意見將用於協助我們的轉移計畫，目標是使 pkg.go.dev 成為我們主要的封裝和模組資訊和說明文件來源。相信您一定希望在 pkg.go.dev 中看到某些事項，請讓我知道這些功能為何！

你可以透過以下管道提供你的意見回饋

在刊登至 Go 問題追蹤器。
傳送電子郵件至 go-discovery-feedback@google.com。
按一下 go.dev 頁尾的「提供意見回饋」或「回報問題」。

在此轉移過程中，我們也會討論讓 API 取得 pkg.go.dev 權限的計畫。我們會在 Go 問題 33654 公布更新資訊。

常見問題

自 11 月推出以來，我們已收到許多 Go 使用者關於 pkg.go.dev 的意見回饋。在貼文的剩餘部分，我們認為回答一些常見問題會很有幫助。

我的套件未顯示在 pkg.go.dev 上！我該如何新增它？

我們定期監控 Go 模組索引，找出要新增至 pkg.go.dev 的新套件。如果你未在 pkg.go.dev 上看到某個套件，你可以從 proxy.golang.org 取得模組版本，並加以新增。請參閱 go.dev/about 以取得說明。

我的套件有授權限制。出了什麼問題？

我們了解無法在 pkg.go.dev 上完整的看到想要的套件會令人沮喪。在我們改進授權偵測演算法的同時，感謝你的耐心等候。

自 11 月推出以來，我們已完成以下改進

更新我們的授權政策，以包含我們偵測並辨識的一系列授權
與 licensecheck 團隊合作，以改善對著作權公告的偵測
為特殊狀況建立手動審查程序

與以往一樣，我們的授權政策在 pkg.go.dev/license-policy。如果你遇到任何問題，請隨時在 Go 問題追蹤器上提交問題，或傳送電子郵件至 go-discovery-feedback@google.com，以便我們能直接協助你！

pkg.go.dev 會開放原始碼嗎？這樣我就能在公司執行，用於我的私有程式碼。

我們了解有私有程式碼的公司想要執行一個提供模組支援的說明文件伺服器。我們希望滿足此需求，但我們認為對此事尚未有深入的了解。

我們聽聞使用者回報執行 godoc.org 伺服器比預期複雜，因為它是設計用於公開網路規模，而非只服務於特定公司內部。我們相信目前的 pkg.go.dev 伺服器會遇到相同問題。

我們認為新的伺服器可能更適合搭配私人程式碼，而非讓每間公司都面臨執行網路規模 pkg.go.dev 程式碼庫的複雜性。除了提供文件之外，新的伺服器還能提供資訊給 goimports 和 gopls。

如果您想執行這樣的伺服器，請填寫這份 3-5 分鐘問卷，協助我們更了解您的需求。此問卷開放至 2020 年 3 月 1 日止。

我們對 2020 年 pkg.go.dev 的未來感到興奮，相信您也會！我們期待收到您的意見回饋，並與 Go 社群合作進行此轉換。

下一篇文章：Go 1.14 已發佈
上一篇文章：Go 1.15 提案
部落格索引