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 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 référentiel et les personnes disposant d’un accès en écriture peuvent activer GitHub Discussions pour une communauté sur leurs référentiels publics, internes 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.
-
Sur GitHub, accédez à la page principale du référentiel.
-
Sous le nom de votre dépôt, cliquez sur Paramètres.
-
Faites défiler jusqu’à la section « Fonctionnalités », puis cliquez sur Configurer les discussions.
-
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é.
-
Cliquez sur 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.
-
Sur GitHub, accédez à la page principale de votre organisation.
-
Sous le nom de votre organisation, cliquez sur Paramètres.
-
Sous « Discussions », sélectionnez Activer les discussions pour cette organisation.
-
Utilisez le menu déroulant pour sélectionner un dépôt à utiliser comme référentiel source pour les discussions de votre organisation.
-
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 « 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.
-
Sur GitHub, accédez à la page principale du référentiel ou de l’organisation où vous souhaitez commencer une discussion.
-
Sous votre dépôt ou nom d’organisation, cliquez sur Discussions.
-
À droite de la page, cliquez sur Nouvelle discussion.
-
Sélectionnez une catégorie de discussion en cliquant sur Prise en main.
-
Sous « Titre de la discussion », tapez un titre pour votre discussion, puis, sous « Écrire », tapez le corps de votre discussion.
-
Cliquez sur 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.
-
Sur GitHub, accédez à la page principale du référentiel.
-
Sous votre dépôt ou nom d’organisation, cliquez sur Discussions.
-
Dans la liste de catégories, cliquez sur Sondages.
-
Sur la droite, cliquez sur Nouvelle discussion.
-
Sous « Titre de la discussion », tapez un titre et éventuellement, sous « Écrire », tapez un corps pour votre sondage.
-
Sous « Question de sondage », tapez une question pour votre sondage.
-
Sous « Options de sondage », tapez au moins deux options pour votre sondage.
-
Si vous le souhaitez, pour ajouter une option de sondage supplémentaire, cliquez sur Ajouter une option.
-
Cliquez sur 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 de catégories pour les discussions ».
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 de 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 de discussions ».