# GitHubでの通信

GitHubのさまざまな種類のディスカッションを使用して、特定のプロジェクトや変更、より広範なアイデアやチームの目標について話し合うことができます。

## はじめに

GitHub には、コミュニティと密接にやり取りできるコラボレーションコミュニケーションツールが組み込まれています。 このクイックスタート ガイドでは、ニーズに適したツールの選択方法について説明します。

どのような会話をしたいかに応じて、課題、プルリクエスト、チームディスカッションを作成して参加できます。

> \[!TIP] また、 コパイロットチャット を使用して、pull request や問題に基づいて、ディスカッションのアイデア、アウトライン、または下書きを生成することもできます。 「[ディスカッションまたはブログ記事を書く](/ja/copilot/tutorials/copilot-cookbook/document-code/write-discussions-or-blog-posts)」を参照してください。

### GitHub Issues

* バグ報告や改善計画、フィードバックなど、プロジェクトの特定の詳細についてのディスカッションに役立ちます。
* リポジトリに固有であり、通常は明確なオーナーがいます。
* GitHubのバグ追跡システムと呼ばれることがよくあります

### Pull Request

* 特定の変更を提案できます。
* 他のユーザーが提案した変更について直接コメントできます。
* リポジトリに固有です。

### GitHub Discussions

* フォーラムのようなもので、コラボレーションが重要なオープン形式のアイデアやディスカッションでの使用に最適です。
* 多数のリポジトリにまたがる場合があります。
* コードベースの外部でコラボレーション エクスペリエンスを提供し、アイデアのブレーンストーミングとコミュニティのナレッジ ベースの作成を可能にします。
* 多くの場合、明確なオーナーはいません。
* 多くの場合、アクション可能なタスクは発生しません

## どのディスカッション ツールを使用すべきか

### 問題のシナリオ

* タスク、機能強化、バグを追跡したい。
* バグ報告を提出したい。
* 特定の機能に関するフィードバックを共有したい。
* リポジトリ内のファイルについて質問したい。

#### 問題の例

この例では、GitHub ユーザーがバグを認識し、修正プログラムについて説明するために、ドキュメント オープンソース リポジトリに問題を作成した方法を示します。

!["通知内の青いリンクのテキストが青の背景で読み取れない" というタイトルの issue のスクリーンショット。](/assets/images/help/issues/issue-example.png)

* ユーザーは、 GitHub Docs の中国語版のページ上部にあるバナーの青い色がバナー内のテキストを読み取れなくなることに気付きました。
* そのユーザーはリポジトリに issue を作成し、問題について述べ、修正プログラム (バナーに別の背景色を使用する) を提案しました。
* ディスカッションが続き、最終的には、修正プログラムの適用に関する合意に達します。
* これで、共同作成者が修正プログラムを含む pull request を作成できます。

### プルリクエストのシナリオ

* リポジトリの入力ミスを修正したい。
* リポジトリに変更を加えたい。
* 変更を加えて issue を修正したい。
* 他の人によって提案された変更についてコメントしたい。

#### プルリクエストの例

この例では、GitHub ユーザーがドキュメント オープンソース リポジトリにプル要求を作成して入力ミスを修正する方法を示します。

pull request の **\[会話]** タブで、作成者が pull request を作成した理由を説明します。

![pull request の \[会話\] タブのスクリーンショット。](/assets/images/help/pull_requests/pr-conversation-example.png)

pull request の **\[ファイルの変更]** タブには、実装された修正プログラムが表示されます。

![pull request の \[ファイルの変更\] タブのスクリーンショット。](/assets/images/help/pull_requests/pr-files-changed-example.png)

* この共同作成者は、リポジトリの入力ミスに気付きました。
* このユーザーが、修正プログラムを含む pull request を作成します。
* リポジトリの保守担当者は、pull request を確認し、それにコメントを付けてマージします。

### GitHub Discussions のシナリオ

* リポジトリ内の特定のファイルに必ずしも関連していない質問がある。
* コラボレーターやチームとニュースを共有したい。
* 自由回答の会話を開始または参加したい。
* コミュニティで発表を行いたい。

#### GitHub Discussions 例

この例では、GitHub Discussions Docs オープンソース リポジトリのGitHubウェルカム 投稿を示し、チームがコミュニティとどのように共同作業を行いたいかを示します。

![ディスカッションの例のスクリーンショット。タイトルは "Welcome to GitHub Docs Discussions" です。](/assets/images/help/discussions/github-discussions-example.png)

このコミュニティ保守担当者は、コミュニティを歓迎し、メンバーに自己紹介を求めるディスカッションを始めました。 この投稿は、訪問者と共同作成者が参加しやすい雰囲気を生み出します。 この投稿では、チームがリポジトリへの投稿を喜んで支援することも明らかになっています。

## Copilotを使用してコンテキストを取得する

> \[!NOTE] GitHub Copilotにアクセスする必要があります。 詳しくは、「[GitHub Copilotとは](/ja/copilot/get-started/what-is-github-copilot#get-access)」をご覧ください。

特定の問題やディスカッションについてより多くのコンテキストや明確さが必要な場合は、 GitHub Copilot を使用して質問に答えることができます。 これにより、すばやく分析情報を得て、複雑なスレッドを理解し、プロジェクトの目標に合わせることができ、コミュニティ内でのコラボレーションと知識共有が促進されます。

問題またはディスカッションについて質問する場合は:

1. GitHubの任意の場所から、ページの右上にある検索バーの横にある\*\*<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="Copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg>\*\* アイコンをクリックします。

   ![新しい会話ボタンのスクリーンショット。濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/copilot/copilot-icon-top-right.png)

2. \[Ask Copilot] ボックスに質問を入力し、関連する URL をメッセージに含めます。 たとえば、次のような質問ができます。

   * `Explain https://github.com/monalisa/octokit/issues/1`
   * `Summarize https://github.com/monalisa/octokit/discussions/4`
   * `Recommend next steps for https://github.com/monalisa/octokit/issues/2`
   * `What are the acceptance criteria for ISSUE URL?`
   * `What are the main points made by PERSON in DISCUSSION URL?`

   特定の問題やディスカッションから GitHub Copilot とチャットする場合は、質問に URL を含める必要はありません。

3. 必要に応じて、質問を送信した後、テキスト ボックス内の <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-square-fill" aria-label="Stop" role="img"><path d="M5.75 4h4.5c.966 0 1.75.784 1.75 1.75v4.5A1.75 1.75 0 0 1 10.25 12h-4.5A1.75 1.75 0 0 1 4 10.25v-4.5C4 4.784 4.784 4 5.75 4Z"></path></svg> をクリックして回答を停止できます。

## 次のステップ

これらの例では、 GitHubでの会話に最適なツールを決定する方法を示しました。 しかし、これは始まりにすぎません。これらのツールをニーズに合わせて調整するためにできることは、他にもたくさんあります。

たとえば、issueは、より迅速に検索できるように issue にラベルをタグ付けしたり、共同作成者が有意義な issue をオープンできるように issue テンプレートを作成したりできます。 詳細については、「[問題について](/ja/issues/tracking-your-work-with-issues/learning-about-issues/about-issues#working-with-issues)」および「[Issueとプルリクエストのテンプレートについて](/ja/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates)」を参照してください。

pull request、提案された変更がまだ進行中の場合は、下書きの pull request を作成できます。 下書きの pull request は、レビュー準備完了としてマークされるまでマージできません。 詳しくは、「[Pull Request](/ja/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests)」をご覧ください。

GitHub Discussionsの場合は行動規範を設定しコミュニティの重要な情報を含むディスカッションをピン留めすることができます。 詳しくは、「[ディスカッションについて](/ja/discussions/collaborating-with-your-community-using-discussions/about-discussions)」をご覧ください。

コミュニケーションに役立つ高度な形式については、「[GitHubでの記述に関するクイック スタート](/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)」を参照してください。