# GitHubでの通信

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

## はじめに

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

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

### GitHub Issues

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

### Pull Request

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

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

### 問題のシナリオ

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

#### 問題の例

この例では、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)

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

## 次のステップ

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

たとえば、issueは、より迅速に検索できるように issue にラベルをタグ付けしたり、共同作成者が有意義な issue をオープンできるように issue テンプレートを作成したりできます。 詳細については、「[問題について](/ja/enterprise-server@3.22/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)」および「[Issueとプルリクエストのテンプレートについて](/ja/enterprise-server@3.22/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/enterprise-server@3.22/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests)」をご覧ください。

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

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