コントリビューションガイドラインについて
プロジェクトの共同作成者が適切な作業を行えるように、コントリビューション ガイドラインを含むファイルをプロジェクト リポジトリのルート、docs
、または .github
フォルダーに追加できます。 プルリクエストをオープンした場合や Issue を作成した場合、そのファイルへのリンクが表示されます。
リポジトリのオーナーにとって、コントリビューションガイドラインとは、人々がどのようにコントリビュートするべきかを伝える方法です。
コントリビューターにとって、このガイドラインは、上手に構築されたプルリクエストの提出をしたり、有益な Issue をオープンすることの確認に役立ちます。
オーナーおよびコントリビューターの双方にとって、コントリビューションガイドラインは、プルリクエストや Issue のリジェクトや再提出の手間を未然に軽減するための有効な手段です。
Organization または個人用アカウント用にデフォルトのコントリビューション ガイドラインを作成できます。 詳しくは、「既定のコミュニティ正常性ファイルの作成」を参照してください。
ヒント: リポジトリの保守担当者は、リポジトリの Issue や pull request のテンプレートを作成して、Issue についての特定のガイドラインを設定できます。 詳しくは、「Issueとプルリクエストのテンプレートについて」を参照してください。
CONTRIBUTING ファイルを追加する
-
GitHub で、リポジトリのメイン ページに移動します。
-
ファイルの一覧の上にある、 [ファイルの追加] ドロップダウンを使用し、 [新しいファイルの作成] をクリックします。
-
リポジトリのルート
docs
または.github
のディレクトリにコントリビューション ガイドラインを保存するかどうかを決定します。 そして、ファイル名のフィールドに、ファイルの名前および拡張子を入力します。 コントリビューションガイドラインのファイル名では大文字と小文字は区別されません。 サポートされているファイル拡張子の場合、ファイルはリッチテキスト形式でレンダリングされます。 詳しくは、「非コード ファイルの操作」を参照してください。- リポジトリのルート ディレクトリにコントリビューション ガイドラインが表示されるようにするには、「CONTRIBUTING」と入力します。
- リポジトリの
docs
ディレクトリにコントリビューション ガイドラインが表示されるようにするには、「docs/ 」と入力して新しいディレクトリを作成してから、「CONTRIBUTING」を入力します。 - リポジトリに複数の CONTRIBUTING ファイルが含まれている場合、リンクに表示されるファイルは、
.github
ディレクトリ、リポジトリのルート ディレクトリ、最後にdocs
ディレクトリの順に選択されます。
-
新しいファイルに、コントリビューションガイドラインを追加します。 このガイドラインには、次のことを含めましょう:
- 有意義な Issue やプルリクエストの作成手順
- - 外部ドキュメント、メーリングリストや行動規範へのリンク
- - コミュニティや行動への期待
-
[コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「複数の作者を持つコミットを作成する」を参照してください。
-
コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「pull request の作成」を参照してください。
-
[変更のコミット] または [変更の提案] をクリックします。
コントリビューションガイドラインの例
最初は悩むかもしれませんが、以下のコントリビューションガイドラインの例を役立ててください:
- GitHub Docs のコントリビューション ガイドライン。
- Ruby on Rails のコントリビューション ガイドライン。
- Open Government のコントリビューション ガイドライン。
参考資料
- オープン ソース ガイドのセクション「Starting an Open Source Project」(オープン ソース プロジェクトの開始)
- 「リポジトリへのライセンスの追加」