Go 部落格

Pkg.go.dev 全新上線！

Julie Qiu
2020年11月10日

自 pkg.go.dev 推出以來，我們收到了許多關於設計和可用性的寶貴反饋。尤其是，大家普遍反映網站資訊組織方式讓使用者在瀏覽時感到困惑。

今天，我們很高興地推出改版後的 pkg.go.dev，希望它能更加清晰和實用。本篇博文將介紹主要亮點。更多詳情，請參閱 Go issue 41585。

最主要的改變是 pkg.go.dev/<path> 頁面圍繞“路徑”這一概念進行了重組。路徑代表了模組特定版本中的一個目錄。現在，無論該目錄中包含什麼內容，每個路徑頁面都將採用相同的佈局，目標是使體驗始終如一且可預測。

如果路徑下存在 README 檔案，路徑頁面將顯示它。之前，“概述”選項卡僅在模組根目錄存在 README 時才顯示。這是我們為將最重要的資訊置於首位所做的眾多更改之一。

文件部分現在顯示一個索引以及一個側邊導航欄。這使使用者能夠在瀏覽文件部分時，同時看到完整的包 API 並保持上下文。左側導航欄中還有一個新的“跳轉到”輸入框，用於搜尋識別符號。

有關文件部分更改的詳細資訊，請參閱 Go issue 41587。

每個頁面的頂部欄現在顯示額外的元資料，例如每個包的“匯入”和“被匯入”計數。橫幅還顯示有關模組最新次要和主要版本的資訊。有關詳細資訊，請參閱 Go issue 41588。

上週在 Google Open Source Live 活動中，我們在演講 Level Up: Go Package Discovery and Editor Tooling 中演示了新網站的體驗。

我們很高興與您分享這次更新的設計。一如既往，請透過網站每頁底部的“分享反饋”和“報告問題”連結告訴我們您的想法。

如果您有興趣為該專案做貢獻，pkg.go.dev 是開源的！請檢視貢獻指南瞭解更多資訊。