ウェブサイト検索

オープンソース ソフトウェアに貢献したいですか?始め方はこちら


明示的に許可されていない限り、プロジェクトに対してテスト コミットやプル リクエストを作成しないでください。このチュートリアルでは、作成したサンプル リポジトリ内の README.md ファイルを編集してください。

GitHub に登録する

GitHub では匿名で編集することはできませんが、サインアップしてサイトの使用を開始するのは簡単です。電子メール アドレスを入力してアカウントを確認する必要があります。

サインアップが完了すると、GitHub を探索し、サービスについて詳しく知るために使用できる個人用ダッシュボードが表示されます。

リポジトリを探す

多くのプロジェクトには単純なテキスト ファイルが含まれており、基本的な編集および書き込みスキルを使用して改善できます。これらのページには、ヘルプ ファイル、Web コンテンツなどが含まれている場合があります。プロジェクトは通常、タイプミスの修正を歓迎し、多くのプロジェクトではテキストを他の言語に翻訳する手助けを必要としています。

一部のプロジェクトは、ほぼ完全にテキストであり、他のプログラムのデータとして機能します。たとえば、tldr はマニュアルページを補完するツールであり、その内容は GitHub リポジトリで管理されます。

プロジェクトの Web サイトには通常、GitHub リポジトリへのリンクがあります。右上にある「Fork me on GitHub」というラベルのリンク、または GitHub の「octocat」ロゴの横にある「GitHub でこのページを検索」のような文言を探してください。

ファイルを編集する

ファイルに直接移動した場合は、この最初の手順をスキップできます。それ以外の場合は、リポジトリのファイル ブラウザを使用して、編集するファイルを見つけます。ファイル名をクリックすると、次のような画面が表示されます。

ページの右側にある鉛筆アイコンをクリックします。所有していないリポジトリからファイルを編集しようとすると、GitHub は最初にファイルをフォークする必要があることを通知します。

これにより、自分のアカウントの下にプロジェクトのコピー (フォーク) が作成されます。変更を加えたら、元のプロジェクト所有者にプル リクエストとして送信できるようになります。

GitHub のブラウザベースのエディタを使用して編集を行います。これは、構文の強調表示などの基本的な機能を備えたシンプルなテキストボックスです。大規模な編集や複雑な編集には使用したくないでしょうが、タイプミスや書式の修正などの簡単な変更には問題ありません。

ファイルを更新したら、「変更をコミット」ボタンをクリックします。次に表示されるテキストボックスに便利な「拡張説明」を追加します。何を変更したかを詳細に説明する必要はありません。変更した理由だけを説明してください。現時点では、これを単純にしておきます。「タイプミスを修正」または「壊れたリンクを置き換え」でも問題ありません。

プルリクエストを開く

「変更を提案」をクリックします。これにより、「変更の比較」という見出しのページが表示され、更新の詳細が表示されます。 「プルリクエストの作成」をクリックします。

次のページでは、タイトルと説明を再度求められます。 1 つのファイルに 1 つの変更を加えているため、以前に指定した詳細が自動的に入力されるはずなので、もう一度 [Create Pull Request] をクリックして続行します。

元のプロジェクトのリポジトリのプル リクエスト ページが表示されます。

次に何が起こるでしょうか?

元のプロジェクトの管理者が変更をレビューします。すべて問題なく、あなたの変更が受け入れられた場合、彼らはあなたのリポジトリからの変更を彼らのリポジトリにマージします。この時点で、オープンソース プロジェクトへの最初のコントリビュートが成功しました。おめでとうございます!

プル リクエストが受け入れられたら、プロジェクトのフォークを安全に削除できます。将来的にさらに貢献する予定がある場合は、フォークを維持できますが、元のプロジェクトの進行に合わせてフォークを更新する方法を学ぶ必要があります。 Git と GitHub に慣れるまでは、更新が必要になるたびに上記のプロセスを使用してプロジェクトをフォークする方が簡単です。

Git について詳しく学ばなくても、多くの種類のプロジェクトに貢献できるようになりました。特に、GitHub Pages 機能を使用すると、プロジェクト Web サイトを無料でホストし、他のリポジトリと同様に管理できます。 [編集] アイコンを使用すると、Web ブラウザーを使用してリアルタイムで Web サイトに変更を加えることができます。