ご協力いただくには

このプロジェクトへのパッチやご協力を歓迎します。従うべき小さなガイドラインがいくつかあります。

コントリビューター ライセンス契約

Google プロジェクトに貢献するには、コントリビューター ライセンス契約を締結する必要があります。これは著作権の譲渡ではなく、プロジェクトの一環として皆さんのコントリビューションを使用し、再配布する権限を Google に付与するだけです。

  • オリジナルのソースコードを記述している個人で、知的財産権を所有していることが確実な場合は、個人用の CLA に署名する必要があります。

  • 貢献を許可したい会社に勤務している場合は、法人の CLA に署名する必要があります。

通常、CLA を提出する必要があるのは 1 回だけです。そのため、すでに CLA をすでに提出している場合は(別のプロジェクト用であっても、再度提出する必要はありません)。

パッチの送信

  1. 通常は、修正しようとしているバグや機能を説明する新しい問題を作成することから始めることをおすすめします。比較的些細なこととお考えであっても、人々が何を取り組んでいるのかを知ることは役に立ちます。最初の問題で、そのバグまたは機能に割り当てを行えるようにする予定であることを説明します。

  2. プロジェクトをフォークする通常のプロセスに沿って、作業する新しいブランチを設定します。pull リクエストにそのバグまたは機能に関連する commit のみが含まれるように、変更の各グループを別々のブランチで行うことが重要です。

  3. 大幅な変更を加える場合は、ほとんどの場合テストが必要です。このプロジェクトはすでに十分なテスト カバレッジを受けているため、どうすればよいかわからない場合は、既存のテストをいくつか確認します。

  4. 変更ごとに正しい形式の commit メッセージを使用するようにしてください。これにより、プロジェクト全体で一貫性が保たれ、さまざまな Git ツールで commit メッセージを適切にフォーマットできるようになります。

  5. 最後に、commit を fork に push し、pull リクエストを送信します。