GitHub はコラボレーション プラットフォーム

  • 8 分

コラボレーションは GitHub が行うあらゆるものの中核です。 このモジュールの最初のユニットでリポジトリについて調べ、リポジトリがプロジェクトとそのファイルの整理に役立つことを学習しました。 直前のユニットでは、プロジェクトに加えられた変更を追跡する方法である pull request について学習しました。

このユニットでは、問題とディスカッションについて学習します。 これらは、GitHub Enterprise プラットフォームが持つ共同制作の性質に貢献する他の 2 つの部分です。

問題

GitHub Issue は、GitHub での作業に関するアイデア、フィードバック、タスク、またはバグを追跡するために作成されました。 issue はさまざまな方法で作成できるため、ワークフローに最も便利な方法を選択できます。

このチュートリアルでは、リポジトリから問題を作成する方法について説明します。 ただし、問題は次のものから作成することもできます。

  • タスク リスト内の項目。
  • プロジェクト内のノート。
  • issue または pull request 内のコメント。
  • 特定のコード行。
  • URL クエリ。

リポジトリからのIssueの作成

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

  2. リポジトリ名の下にある、[Issues] を選択します。

    [Issues]\(問題\) セクションが強調表示されているリポジトリのメイン ページの上部を示すスクリーンショット。

  3. [New issue] (新しい issue) を選択します。

  4. リポジトリで issue テンプレートが使用されている場合は、開きたい issue の種類の横にある [作業の開始] を選択します。

    開きたい issue の種類が選択可能なオプションに含まれていない場合は、[Open a blank issue] (空の issue を開く) を選択します。 テンプレートを使用しない場合は、手順 5 に進みます。

    [Open a blank issue]\(空の問題を開く\) オプションが強調表示されている issue テンプレート メニューのスクリーンショット。

  5. [タイトルの追加] フィールドに、issue のタイトルを入力します。

  6. [説明を追加する] フィールドに、issue の説明を入力します。

  7. プロジェクトのメンテナは、Issue を他のユーザーに割り当てたり、プロジェクト ボードに追加したり、マイルストーンに関連付けたり、ラベルを適用したりできます。

  8. 入力が終わったら、[新しい issue を送信] を選びます。

一部の会話は、GitHub Discussions により適しています。 GitHub Discussions を使用して、質問と回答、情報の共有、お知らせ、プロジェクトに関する会話の実施または参加を行うことができます。

次のセクションでは、Discussions と、この機能を最適に利用する方法を確認します。

ディスカッション

discussion は、誰もがアクセスできる必要があり、コードに関連しない会話を対象としています。 Discussions により、公開フォーラムで流動的でオープンな会話ができるようになります。

このセクションで、次の手順を実行します。

  • リポジトリ内で discussion を有効にします。
  • 新しい discussion と discussion のさまざまなカテゴリを作成します。

では、リポジトリ内での discussion の有効化について詳しく見てみることにしましょう。

リポジトリ内での discussion の有効化

リポジトリ所有者と書き込みアクセス権を持つユーザーは、パブリック リポジトリとプライベート リポジトリ上のコミュニティに対して GitHub Discussions を有効にすることができます。 ディスカッションの可視性は、ディスカッションが作成されたリポジトリから継承されます。

初めて GitHub Discussions を有効にする際、ウェルカム投稿を構成するように求められます。

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

  2. リポジトリ名の下で、 [設定] を選択します。

    [設定] セクションが強調表示されているリポジトリのメイン ページの上部のスクリーンショット。

  3. [機能] セクションまで下にスクロールし、[Discussions] の下で [discussion の設定] を選択します。

    緑色の [Setup discussion]\(ディスカッションのセットアップ\) ボタンが強調表示されている [ディスカッション] ボックスのスクリーンショット。

  4. [Start a new discussion] (新しい discussion を開始する) で、コミュニティに設定するリソースとトーンに合わせてテンプレートを編集します。

  5. [Start discussion] (discussion を開始) を選択します。

以上で、新しい discussion を作成する準備ができました。

新しい discussion を作成する

リポジトリを表示できる認証されたユーザーが、そのリポジトリでディスカッションを作成できます。 同様に、組織のディスカッションはソース リポジトリに基づいているため、ソース リポジトリを表示できる認証されたユーザーは、その組織でディスカッションを作成できます。

  1. GitHub.com で、discussion を開始するリポジトリまたは organization のメイン ページに移動します。

  2. リポジトリ名または organization 名の下にある [Discussions] を選択します。

    [ディスカッション] セクションが強調表示されているリポジトリのメイン ページの上部のスクリーンショット。

  3. ページの右側で [New discussion] (新しい discussion) を選択します。

  4. [作業の開始] を選択して、discussion カテゴリを選択します。 すべてのディスカッションは、カテゴリ内に作成しなければなりません。 リポジトリディスカッションの場合、リポジトリの保守管理または管理のアクセス許可を持つユーザがそのリポジトリでディスカッションのカテゴリを定義します。

    上部のオプション [お知らせ] と [作業の開始] ボタンが強調表示されたディスカッション カテゴリを選択するメニューの選択のスクリーンショット。

各カテゴリには一意の名前、絵文字の組み合わせ、その目的を示す詳細な説明が必要です。 カテゴリは、保守担当者が会話の登録方法を整理するのに役立ちます。 これらは、Q&A、またはより自由な回答式の会話であるカテゴリが区別しやすくなるようにカスタマイズできます。 次の表は、discussion の既定のカテゴリとその目的を示しています。

カテゴリ 目的 フォーマット
📣 お知らせ プロジェクトの保守担当者からの更新とニュース 告知
#️⃣ 全般 プロジェクトに関連するすべての事柄 自由回答形式のディスカッション
💡 アイデア プロジェクトを変更または改善するためのアイデア 自由回答形式のディスカッション
🗳️ 投票 コミュニティが投票したり議論したりするための複数のオプションを含むアンケート アンケート
🙏 Q&A コミュニティが回答する質問 (質問/回答形式) 質問と回答
🙌 表示と通知 プロジェクトに関連する作成物、実験、またはテスト 自由回答形式のディスカッション

  1. [discussion のタイトル] の下に、discussion のタイトルを入力し、[書き込み] の下に、discussion の本文を入力します。

    [ディスカッション] タイトル ボックスとコンテンツ ボックスが空の新しいディスカッション ページを開始するスクリーンショット。

  2. [Start discussion] (discussion を開始) を選択します。

ここでは、GitHub がどのようにコラボレーションを促進するかについて簡単に説明しました。 次に、通知の管理、スレッドへのサブスクライブ、GitHub ページの使用を開始する方法に進みましょう。