リポジトリコントリビューターのためのガイドラインを定める

プロジェクトに人々がどのようにコントリビュートするべきかを伝えるガイドラインを作成できます。

この記事で

コントリビューションガイドラインについて

プロジェクトの共同作成者が適切な作業を行えるように、コントリビューション ガイドラインを含むファイルをプロジェクト リポジトリのルート、docs、または .github フォルダーに追加できます。 プルリクエストをオープンした場合や Issue を作成した場合、そのファイルへのリンクが表示されます。 投稿ガイドラインへのリンクは、リポジトリの contribute ページにも表示されます。 contribute ページの例については、github/docs/contribute を参照してください。

          リポジトリに `CONTRIBUTING.md` ファイルが含まれている場合、 GitHub は他の 2 つの場所にも表示され、共同作成者が簡単に見つけられるようになります。
  • リポジトリの概要の [ 投稿] タブ ([ README] と [ 行動基準] の横)
  • リポジトリ サイドバーの [投稿中] リンク

リポジトリのオーナーにとって、コントリビューションガイドラインとは、人々がどのようにコントリビュートするべきかを伝える方法です。

コントリビューターにとって、このガイドラインは、上手に構築されたプルリクエストの提出をしたり、有益な Issue をオープンすることの確認に役立ちます。

オーナーおよびコントリビューターの双方にとって、コントリビューションガイドラインは、不適切なプルリクエストや Issue によって引き起こされるリジェクトおよび再提出の手間を省くための有効な手段です。

Organization または個人用アカウント用にデフォルトのコントリビューション ガイドラインを作成できます。 詳しくは、「既定のコミュニティ正常性ファイルの作成」をご覧ください。

ヒント

リポジトリの保守担当者は、そのリポジトリの issue や pull request のテンプレートを作成して、issue についての特定のガイドラインを設定できます。 詳しくは、「Issueとプルリクエストのテンプレートについて」をご覧ください。

          `CONTRIBUTING.md` ファイルの追加

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. ファイルの一覧の上にある [Add file ] ドロップダウン メニューを選んでから、[ Create new file] をクリックします。

    または、左側のファイル ツリー ビューの をクリックしてもかまいません。

    上で説明した [Add file] と "プラス記号" アイコンの両方がオレンジ色の枠線で強調されている、リポジトリのメイン ページのスクリーンショット。

  3. リポジトリのルート docs または .github のディレクトリにコントリビューション ガイドラインを保存するかどうかを決定します。 そして、ファイル名のフィールドに、ファイルの名前および拡張子を入力します。 コントリビューションガイドラインのファイル名では大文字と小文字は区別されません。 サポートされているファイル拡張子の場合、ファイルはリッチテキスト形式でレンダリングされます。 詳しくは、「非コード ファイルの操作」をご覧ください。

    • リポジトリのルート ディレクトリにコントリビューション ガイドラインが表示されるようにするには、「CONTRIBUTING」と入力します。
    • リポジトリの docs ディレクトリにコントリビューション ガイドラインが表示されるようにするには、「docs/ 」と入力して新しいディレクトリを作成してから、「CONTRIBUTING」を入力します。
    • リポジトリに複数の CONTRIBUTING ファイルが含まれている場合、リンクに表示されるファイルは、.github ディレクトリ、リポジトリのルート ディレクトリ、最後に docs ディレクトリの順に選択されます。

  4. 新しいファイルに、コントリビューションガイドラインを追加します。 このガイドラインには、次のことを含めましょう:

    • 有意義な Issue やプルリクエストの作成手順
    • - 外部ドキュメント、メーリングリストや行動規範へのリンク
    • - コミュニティや行動への期待

  5. [変更のコミット...] をクリックします。

  6. [コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「複数の作者を持つコミットを作成する」をご覧ください。

  7. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「pull request の作成」をご覧ください。

    GitHub pull request のスクリーンショット。メイン ブランチに直接コミットする、または新しいブランチを作成するためのラジオ ボタンが表示されています。 新しいブランチが選ばれています。

  8. [変更のコミット] または [変更の提案] をクリックします。

コントリビューションガイドラインの例

最初は悩むかもしれませんが、以下のコントリビューションガイドラインの例を役立ててください:

参考資料