Go 部落格
pkg.go.dev 的下一步
引言
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 issue tracker 上發帖。
- 傳送電子郵件至 go-discovery-feedback@google.com。
- 點選 go.dev 頁尾中的“分享反饋”或“報告問題”。
作為此次過渡的一部分,我們還將討論 pkg.go.dev 的 API 訪問計劃。我們將在 Go issue 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 issue tracker 上提交問題,或傳送電子郵件至 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 提案
部落格索引