GitHub Discussions のクイックスタート

はじめに

GitHub Discussions は、オープンソースプロジェクトに関するコミュニティ向けの共同コミュニケーションフォーラムです。 Discussions は、Issue とは異なり、プロジェクトボードで追跡する必要がなく、コードに関連しない会話のためのものですが、透明性があり利用しやすいものである必要があります。 Discussions により、公開フォーラムで流動的でオープンな会話ができるようになります。

Discussions では、より協力的な会話ができるように、情報に接続して検索するためのより一元的なエリアを提供しています。

リポジトリの GitHub Discussions を有効化する

リポジトリのオーナーと書き込みアクセスを持つユーザは、パブリックリポジトリのコミュニティに対して GitHub Discussions を有効化できます。

GitHub Discussions を最初に有効化すると、ウェルカム投稿を設定するように求められます。

1. GitHubで、リポジトリのメインページにアクセスしてください。
2. リポジトリ名の下で Settings（設定）をクリックしてください。
   
3. [Features] で、[Set up discussions] をクリックします。
   
4. [Start a new discussion] で、テンプレートを編集してコミュニティに設定するリソースと方向性を合わせます。
5. Click Start discussion.
   

ディスカッションへのコントリビューションを歓迎する

ウェルカム投稿を作成して、その投稿を GitHub Discussions ページにピン留めすることで、コミュニティを歓迎し、リポジトリ内の新しいコミュニケーションの導入について紹介します。 ディスカッションをピン留めしてロックすると、投稿がお知らせであることを周知するのに役立ちます。 お知らせを使用すると、ユーザをより多くのリソースにリンクし、コミュニティでディスカッションをオープンするためのガイダンスを提供できます。 ディスカッションのピン留めに関する詳しい情報については、「リポジトリ内のディスカッションを管理する」を参照してください。

コントリビューター向けのコミュニティガイドラインを設定する

コントリビューションガイドラインを設定して、コラボレータがリポジトリについて有意義で有用な会話を行うよう促すことができます。 リポジトリの README を更新して、コラボレータが Issue やディスカッションをオープンするタイミングを伝えることもできます。

プロジェクトのガイドラインの提供方法の詳細については、「プロジェクトに行動規範を追加する」および 「健全なコントリビューションのためのプロジェクトの設定」を参照してください。

新しいディスカッションを作成する

リポジトリへのアクセス権限を持つユーザは、ディスカッションを作成できます。

1. GitHubで、リポジトリのメインページにアクセスしてください。
2. Under your repository name, click Discussions.
   
3. Click New discussion.
   
4. Select the Select Category drop-down menu, and click a category for your discussion.
   
5. Type a title and body for your discussion.
   
6. Click Start discussion.
   

ディスカッションを関連するカテゴリに整理する

リポジトリの所有者と書き込みアクセス権を持つユーザは、新しいカテゴリを作成してディスカッションを整理できます。 参加しているコラボレータが新しいディスカッションを作成する場合、ディスカッションを最も関連性の高い既存のカテゴリにグループ化できます。 ディスカッションは、作成後に再分類することもできます。 詳しい情報については、「リポジトリ内のディスカッションのカテゴリを管理する」を参照してください。

健全な会話を促進する

リポジトリへの書き込み権限を持つユーザは、ディスカッションをピン留めし、役に立たなくなった、またはコミュニティに害を与えているディスカッションを削除し、Organization が所有するより関連性の高いリポジトリにディスカッションを移譲することで、重要な会話を明示できます。 詳しい情報については、「リポジトリ内のディスカッションを管理する」を参照してください。

リポジトリのトリアージ権限を持つユーザは、コメントを回答としてマークし、役に立たなくなった、またはコミュニティに損害を与えているディスカッションをロックし、アイデアがまだ開発の初期段階にあるときに Issue をディスカッションに変換することで、プロジェクトのディスカッションをモデレートするのに役立ちます。 詳しい情報については、「 ディスカッションをモデレートする」を参照してください。

次のステップ

作業を確認してアイデアをコンセプトから現実に移すための明確な道筋ができたら、Issue を作成して進捗状況の追跡を開始できます。 ディスカッションから Issue を作成する際の詳しい情報については、「 ディスカッションをモデレートする」を参照してください。