Goブログ

Pkg.go.devが新しくなりました！

Julie Qiu
2020年11月10日

pkg.go.devをリリースして以来、デザインと使いやすさについて多くの素晴らしいフィードバックをいただきました。特に、サイトをナビゲートする際に情報の整理方法がユーザーを混乱させていることは明らかでした。

本日、より明確で役に立つことを願って、再設計されたpkg.go.devを発表できることを嬉しく思います。このブログ投稿では、ハイライトを紹介します。詳細については、Go issue 41585を参照してください。

すべてのパスに一貫したランディングページ

主な変更点は、pkg.go.dev/<path>ページがパスの概念を中心に再構成されたことです。パスは、モジュールの特定のバージョン内のディレクトリを表します。 теперь, そのディレクトリの内容に関係なく、すべてのパスページは同じレイアウトになり、一貫して便利で予測可能なエクスペリエンスを提供することを目標としています。

Landing page for cloud.google.com/go/storage — 図1. https://pkg.go.dev/cloud.google.com/go/storageのランディングページ。

パスページには、存在する場合はそのパスのREADMEが表示されます。以前は、概要タブには、モジュールルートに存在する場合にのみREADMEが表示されていました。これは、最も重要な情報を前面に表示するという、私たちが行っている多くの変更の1つです。

ドキュメントセクションには、サイドナビゲーションとともにインデックスが表示されるようになりました。これにより、ドキュメントセクションをナビゲートしながら、完全なパッケージAPIを確認できます。また、識別子を検索するための新しい「ジャンプ先」入力ボックスが左側のサイドナビゲーションに追加されました。

Jump To feature navigating net/http — 図2. https://pkg.go.dev/net/httpの「ジャンプ先」機能。

ドキュメントセクションの変更の詳細については、Go issue 41587を参照してください。

メインページのメタデータ

各ページの上部バーには、各パッケージの「インポート数」と「インポート元」の数などの追加のメタデータが表示されるようになりました。バナーには、モジュールの最新のマイナーバージョンとメジャーバージョンに関する情報も表示されます。詳細については、Go issue 41588を参照してください。

Header metadata for github.com/russross/blackfriday — 図3. https://pkg.go.dev/github.com/russross/blackfridayのヘッダーメタデータ。

ビデオ解説

先週のGoogle Open Source Liveでは、講演「レベルアップ：Goパッケージの検出とエディタートーリング」で、新しいサイトエクスペリエンスの解説を行いました。

フィードバック

この更新されたデザインを皆様と共有できることを嬉しく思います。いつものように、各ページの下部にある「フィードバックを送信」と「問題を報告」リンクからご意見をお聞かせください。

そして、このプロジェクトへの貢献に関心のある方は、pkg.go.devはオープンソースです！貢献ガイドラインを確認して詳細を確認してください。