Go 部落格
pkg.go.dev 的後續步驟
引言
2019 年,我們推出了 go.dev,這是 Go 開發人員的新中心。
作為該網站的一部分,我們還推出了 pkg.go.dev,這是 Go 包和模組資訊的中心來源。與 godoc.org 一樣,pkg.go.dev 提供 Go 文件。但是,它還能理解模組,幷包含有關包 past 版本的資訊!
今年 throughout,我們將為 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 頁尾中點選“Share Feedback”或“Report an Issue”。
作為此次過渡的一部分,我們還將討論 pkg.go.dev 的 API 訪問計劃。我們將在 Go issue 33654 上釋出更新。
常見問題解答
自 11 月推出以來,我們收到了 Go 使用者關於 pkg.go.dev 的大量寶貴反饋。在本文的其餘部分,我們認為回答一些常見問題會有所幫助。
我的包沒有顯示在 pkg.go.dev 上!如何新增?
我們定期監控 Go Module Index,以查詢新包並將其新增到 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 日結束。
我們對 pkg.go.dev 在 2020 年的未來感到興奮,希望您也是!我們期待聽到您的反饋,並在過渡過程中與 Go 社群合作。
下一篇文章:Go 1.14 釋出
上一篇文章:Go 1.15 提案
部落格索引