Go ブログ
pkg.go.dev の次のステップ
はじめに
2019 年に、Go 開発者向けの新しいハブである go.dev を立ち上げました。
サイトの一部として、Go パッケージとモジュールに関する情報の中央ソースである pkg.go.dev も立ち上げました。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 に表示されません。どうすれば追加できますか?
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 コードベースの実行の複雑さをすべての企業に公開する代わりに、プライベートコードでの使用には新しいサーバーがより適切な回答となる可能性が高いと考えています。新しいサーバーは、ドキュメントの提供に加えて、goimports および gopls に情報を提供することもできます。
そのようなサーバーを実行したい場合は、ニーズをより深く理解するために、この 3〜5分のアンケート にご記入ください。このアンケートは 2020 年 3 月 1 日までご利用いただけます。
2020 年の pkg.go.dev の将来に興奮しており、皆様もそうであってほしいと願っています。皆様からのフィードバックをお待ちしており、この移行について Go コミュニティと協力できることを楽しみにしています。
次の記事: Go 1.14 がリリースされました
前の記事: Go 1.15 の提案
ブログインデックス