The Go Blog

pkg.go.devの次のステップ

Julie Qiu
2020年1月31日

はじめに

2019年に、Go開発者向けの新しいハブであるgo.devを立ち上げました。

このサイトの一部として、Goパッケージとモジュールに関する情報の一元的な情報源であるpkg.go.devも立ち上げました。godoc.orgと同様に、pkg.go.devはGoドキュメントを提供します。しかし、モジュールを理解し、パッケージの過去のバージョンに関する情報も持っています!

今年1年間を通して、ユーザーが依存関係をよりよく理解し、どのライブラリをインポートするかについてより良い決定を下せるように、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に表示されません!どうすれば追加できますか?

私たちは、pkg.go.devに追加する新しいパッケージについて、Go Module Indexを定期的に監視しています。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コードベースを実行する複雑さをさらすのではなく、プライベートコードで使用するための新しいサーバーがより適切な解決策になる可能性が高いと考えています。新しいサーバーは、ドキュメントを提供するだけでなく、goimportsgoplsにも情報を提供できます。

そのようなサーバーを実行したい場合は、皆様のニーズをよりよく理解するために、この3〜5分間のアンケートにご記入ください。このアンケートは2020年3月1日まで利用可能です。

2020年のpkg.go.devの未来に興奮しています。皆様もそうであることを願っています!皆様からのフィードバックを楽しみにしています。この移行についてGoコミュニティと協力していきます。

次の記事: Go 1.14がリリースされました
前の記事: Go 1.15の提案
ブログインデックス