Skip to main content

Guide de démarrage rapide pour GitHub Discussions

Activez GitHub Discussions sur un dépôt ou une organisation existant et commencez des conversations avec votre communauté.

Introduction

GitHub Discussions est un forum de communication collaboratif pour la communauté autour d’un projet open source ou interne. Les discussions sont destinées aux conversations qui doivent être transparentes et accessibles, mais ne doivent pas être suivies sur un tableau de projet et ne sont pas liées au code, contrairement aux GitHub Issues. Les discussions permettent une conversation fluide et ouverte dans un forum public.

Les discussions donnent un espace pour des conversations plus collaboratives en se connectant et en donnant une zone plus centralisée pour se connecter et trouver des informations.

Activation de GitHub Discussions sur votre référentiel

Les propriétaires de dépôts et les personnes avec un accès en écriture peuvent activer GitHub Discussions pour une communauté sur leurs dépôts publics et privés. La visibilité d’une discussion est héritée du dépôt dans lequel la discussion est créée.

Lorsque vous activez GitHub Discussions pour la première fois, vous êtes invité à configurer un message d’accueil.

  1. Dans GitHub.com, accédez à la page principale du dépôt.
  2. Sous le nom de votre référentiel, cliquez sur Paramètres. Bouton Paramètres publics
  3. Sous « Fonctionnalités », cliquez sur Configurer les discussions. Configurer un bouton de discussion sous « Fonctionnalités » pour activer ou désactiver GitHub Discussions pour un référentiel
  4. Sous « Démarrer une nouvelle discussion », modifiez le modèle pour s’aligner sur les ressources et le ton que vous souhaitez définir pour votre communauté.
  5. Cliquez sur Démarrer la discussion. Bouton « Démarrer la discussion »

Activation de GitHub Discussions sur votre organisation

Les propriétaires d’organisation peuvent activer GitHub Discussions pour leur organisation.

Lorsque vous activez les discussions d’organisation, vous choisissez un dépôt dans l’organisation comme dépôt source pour les discussions de votre organisation. Vous pouvez utiliser un dépôt existant ou créer un dépôt spécifiquement pour contenir les discussions de votre organisation. Les discussions s’affichent à la fois dans la page des discussions de l’organisation et dans la page de discussion du dépôt source.

L’autorisation de participer à des discussions, ou de les gérer, dans votre organisation est basée sur l’autorisation dans le dépôt source. Par exemple, un utilisateur a besoin d’une autorisation en écriture sur le dépôt source pour supprimer une discussion d’organisation. Cela est identique à la façon dont un utilisateur a besoin d’une autorisation en écriture dans un dépôt pour supprimer une discussion de dépôt.

Vous pouvez modifier le dépôt source à tout moment. Si vous modifiez le dépôt source, les discussions ne sont pas transférées vers le nouveau dépôt source.

  1. Sur GitHub.com, accédez à la page principale de votre organisation.
  2. Sous le nom de votre organisation, cliquez sur Paramètres. Bouton Paramètres de l’organisation
  3. Sous « Discussions », sélectionnez Activer les discussions pour cette organisation.
  4. Sélectionnez un référentiel à utiliser comme référentiel source pour les discussions de votre organisation. Paramètres pour permettre les discussions pour une organisation
  5. Cliquez sur Enregistrer.

Contributions d’accueil dans vos discussions

Vous pouvez accueillir votre communauté et introduire une nouvelle façon de communiquer dans un référentiel ou une organisation en créant un message d’accueil et en l’épinglant sur votre page GitHub Discussions. L’épinglage et le verrouillage des discussions aident les gens à savoir qu’une publication est une annonce. Vous pouvez utiliser des annonces comme moyen de lier des personnes à d’autres ressources et d’offrir des conseils pour ouvrir des discussions dans votre communauté. Pour plus d’informations sur l’épinglage d’une discussion, consultez « Gestion des discussions ».

Configuration des lignes directrices de la communauté pour les contributeurs

Pour les discussions de référentiel, vous pouvez définir des lignes directrices de contribution pour encourager les collaborateurs à avoir des conversations significatives et utiles qui sont pertinentes pour le référentiel. Vous pouvez également mettre à jour le fichier README du référentiel pour communiquer les attentes qui déterminent quand les collaborateurs doivent ouvrir un problème ou une discussion. Pour plus d’informations sur l’offre de recommandations pour votre projet, consultez « Ajout d’un code de conduite à votre projet » et « Configuration de votre projet pour des contributions saines. »

Pour les discussions de l’organisation, vous partagez des informations sur la façon d’interagir avec votre organisation en créant un README pour le profil de l’organisation. Pour plus d’informations, consultez « Personnalisation du profil de votre organisation ».

Création d’une discussion

Tout utilisateur authentifié qui peut afficher le référentiel peut créer une discussion dans ce référentiel. De même, étant donné que les discussions de l’organisation sont basées sur un référentiel source, tout utilisateur authentifié qui peut afficher le référentiel source peut créer une discussion dans cette organisation.

  1. Sur GitHub.com, accédez à la page principale du référentiel ou de l’organisation où vous souhaitez commencer une discussion.
  2. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions. Onglet « Discussions » d’un dépôt
  3. Cliquez sur Nouvelle discussion. Bouton « Nouvelle discussion » sous l’onglet « Discussions » pour un dépôt
  4. Sélectionnez le menu déroulant Sélectionner une catégorie et cliquez sur une catégorie pour votre discussion. Menu déroulant « Sélectionner une catégorie » et liste des catégories disponibles dans un dépôt
  5. Tapez un titre et un corps pour votre discussion. Champs de texte pour le titre et le corps de la nouvelle discussion
  6. Cliquez sur Démarrer la discussion. Bouton « Démarrer la discussion »

Création d’une nouvelle interrogation

Tout utilisateur authentifié qui peut afficher un référentiel peut créer un sondage. De même, étant donné que les discussions de l’organisation sont basées sur un référentiel source, tout utilisateur authentifié qui peut afficher le référentiel source peut créer un sondage dans cette organisation.

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions. Onglet « Discussions » d’un dépôt
  2. Dans la liste de catégories, cliquez sur Sondages. Capture d’écran montrant la catégorie « Sondage »
  3. Sur la droite, cliquez sur Démarrer le sondage. Capture d’écran montrant le bouton « Démarrer le sondage »
  4. Entrez un titre et un corps facultatif pour votre sondage. Capture d’écran montrant les champs de texte pour le titre et le corps
  5. Entrez une question pour votre sondage. Capture d’écran montrant les champs de texte de la question du sondage
  6. Entrez au moins deux options pour votre sondage. Capture d’écran montrant les champs de texte des options du sondage
  7. Pour ajouter une option de sondage supplémentaire, vous pouvez cliquer sur Ajouter une option. Capture d’écran montrant le bouton « Ajouter une option »
  8. Cliquez sur Démarrer le sondage. Capture d’écran montrant le bouton « Démarrer le sondage »

Organisation de discussions

Les propriétaires et les personnes disposant d’un accès en écriture au référentiel peuvent créer de nouvelles catégories pour organiser les discussions. De même, étant donné que les discussions de l’organisation sont basées sur un référentiel source, les propriétaires de référentiel et les personnes disposant d’un accès en écriture au référentiel source peuvent créer de nouvelles catégories pour les discussions de l’organisation.

Les collaborateurs participant et créant de nouvelles discussions peuvent regrouper des discussions dans les catégories existantes les plus pertinentes. Les discussions peuvent également être reclassées après leur création. Pour plus d’informations, consultez « Gestion des catégories de discussion ».

Pour organiser des discussions de manière plus granulaire, vous pouvez appliquer des étiquettes. Par exemple, vous pouvez utiliser des étiquettes pour indiquer l’état d’une discussion afin de rendre le triage plus efficace. Chaque dépôt a un ensemble partagé d’étiquettes pour les problèmes, les demandes de tirage et les discussions. Pour plus d’informations, consultez « Gestion des étiquettes ».

Promouvoir des conversations saines

Les personnes disposant d’autorisations d’écriture pour le référentiel ou pour le référentiel source pour les discussions de l’organisation peuvent aider à faire ressortir les conversations importantes en épinglant des discussions, en supprimant des discussions qui ne sont plus utiles ou qui sont préjudiciables à la communauté, et en transférant des discussions vers des référentiels plus pertinents appartenant à l’organisation. Pour plus d’informations, consultez Gestion des discussions.

Les personnes avec des autorisations de triage sur le référentiel, ou pour le référentiel source pour les discussions de l’organisation, peuvent aider à modérer les discussions d’un projet en marquant les commentaires comme des réponses, en verrouillant les discussions qui ne sont plus utiles ou qui sont préjudiciables à la communauté et en convertissant les problèmes en discussions quand une idée est encore en phase initiale de développement. Pour plus d’informations, consultez « Modération des discussions ».

Étapes suivantes

Une fois qu’il existe un chemin clair pour définir l’étendue et passer une idée du concept à la réalité, vous pouvez créer un problème et commencer à suivre votre progression. Pour plus d’informations sur la création d’un problème à partir d’une discussion, consultez « Modération des discussions ».