Collaboration avec les chargés de maintenance à travers les discussions

Vous pouvez contribuer aux objectifs, plans, santé et communauté d’un projet dans GitHub en communiquant avec les chargés de maintenance du projet dans une discussion.

Qui peut utiliser cette fonctionnalité ?

People with read access to a repository can start and participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can start and participate in discussions and polls in the organization.

Dans cet article

À propos de la collaboration avec les chargés de maintenance en utilisant GitHub Discussions

GitHub Discussions est un forum ouvert pour la conversation entre les chargés de maintenance et la communauté d’un dépôt ou d’une organisation sur GitHub. Si vous utilisez un projet ou contribuez à un projet, vous pouvez commencer une discussion pour formuler des suggestions, et entrer en contact avec les chargés de maintenance et les membres de la communauté au sujet de vos plans, questions, idées et commentaires. Pour plus d’informations, consultez « À propos des discussions ».

Toutes les discussions doivent être créées dans une catégorie. Pour les discussions de référentiel, les personnes disposant d’autorisations d’administration ou de maintenance sur le référentiel définissent les catégories de discussions de ce référentiel. Pour les discussions d’organisation, les personnes disposant d’autorisations d’administration ou de maintenance sur le référentiel source définissent les catégories des discussions dans cette organisation. Chaque catégorie est doté d’un format : discussion ouverte, question et réponse, ou annonce. Les chargés de maintenance peuvent utiliser des catégories avec le format d’annonce pour partager des informations, des versions ou des événements. Pour conserver les discussions dans ces catégories axées sur les mises à jour importantes, seules les personnes disposant d’autorisations d’administration ou de maintenance peuvent créer de nouvelles discussions, mais tout le monde peut commenter et répondre.

Les administrateurs de dépôt et les chargés de maintenance de projet peuvent supprimer une discussion dans ce dépôt. De même, les administrateurs et les chargés de maintenance du dépôt source des discussions d’une organisation peuvent supprimer une discussion dans cette organisation. Pour plus d’informations, consultez « Gestion des discussions ».

GitHub reconnaît automatiquement les membres de la communauté qui contribuent le plus avec des commentaires marqués comme des réponses dans les discussions au format question/réponse. Ces membres apparaissent dans une liste des contributeurs les plus utiles aux discussions du projet, si leurs paramètres de confidentialité le permettent. Pour plus d’informations, consultez « Définition de votre profil sur privé ».

Quand votre projet se développe, vous pouvez accorder des autorisations d’accès plus élevées aux membres actifs de votre communauté. Pour plus d’informations, consultez « Octroi d’autorisations plus élevées aux principaux contributeurs ».

Capture d’écran de la page « Discussions » dans un dépôt. La section « Les plus utiles » est délimitée en orange foncé.

Les membres de la communauté peuvent voter des discussions et des commentaires de niveau supérieur dans les discussions pour communiquer avec les personnes partagent sur des idées qui leur importent. Les chargés de maintenance de projet peuvent ensuite trier les discussions et les commentaires en fonction des votes pour obtenir un aperçu de ce que les membres de la communauté apprécient.

Pour plus d’informations sur la participation à des discussions, consultez « Participation à une discussion ».

Prérequis

Pour collaborer avec des chargés de maintenance dans des discussions de dépôt, un administrateur de dépôt ou un chargé de maintenance de projet doit activer GitHub Discussions pour le dépôt. Pour plus d’informations, consultez « Activation ou désactivation de GitHub Discussions pour un dépôt ».

Pour collaborer avec les chargés de maintenance dans les discussions de l’organisation, GitHub Discussions doit être activé pour l’organisation. Pour plus d’informations, consultez « Activation ou désactivation de GitHub Discussions pour une organisation ».

Démarrage d’une discussion

  1. Sur GitHub, 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.

    Capture d’écran des onglets d’un dépôt GitHub. L’option « Discussions » est présentée en orange foncé.

  3. À droite de la page, cliquez sur Nouvelle discussion.

  4. Sélectionnez une catégorie de discussion en cliquant sur Prise en main.

    Capture d’écran de la page « Sélectionner une catégorie de discussion ». Un bouton intitulé « Prise en main » est indiqué en orange foncé.

  5. Sous « Titre de la discussion », tapez un titre pour votre discussion, puis, sous « Écrire », tapez le corps de votre discussion.

    Capture d’écran des champs de texte pour le titre et le corps d’une nouvelle discussion.

  6. Cliquez sur Démarrer la discussion.

Démarrage d’un sondage

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions.

    Capture d’écran des onglets d’un dépôt GitHub. L’option « Discussions » est présentée en orange foncé.

  3. Dans la liste de catégories, cliquez sur Sondages.

    Capture d’écran de la section Catégories sous l’onglet « Discussions ». La catégorie « Sondage » est délimitée en orange foncé.

  4. Sur la droite, cliquez sur Nouvelle discussion.

  5. Sous « Titre de la discussion », tapez un titre et éventuellement, sous « Écrire », tapez un corps pour votre sondage.

    Capture d’écran de la page permettant de démarrer un nouveau sondage.

  6. Sous « Question de sondage », tapez une question pour votre sondage.

  7. Sous « Options de sondage », tapez au moins deux options pour votre sondage.

  8. Si vous le souhaitez, pour ajouter une option de sondage supplémentaire, cliquez sur Ajouter une option.

    Capture d’écran de la page permettant de démarrer un nouveau sondage. L’icône plus et le lien « Ajouter une option » sont présentés en orange foncé.

  9. Cliquez sur Démarrer le sondage.

Filtrage de la liste de discussions

Vous pouvez rechercher des discussions et filtrer la liste des discussions dans un dépôt ou une organisation. Pour plus d’informations, consultez « Recherche de discussions ».

  1. Sur GitHub, naviguez vers la page principale du référentiel ou de l’organisation.

  2. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions.

    Capture d’écran des onglets d’un dépôt GitHub. L’option « Discussions » est présentée en orange foncé.

  3. Dans le champ Rechercher dans toutes les discussions, tapez une requête de recherche. À droite du champ de recherche, vous pouvez cliquer sur un bouton pour filtrer davantage les résultats.

    Capture d’écran de la barre de recherche et des boutons pour filtrer les discussions.

  4. Dans la liste des discussions, cliquez sur la discussion à afficher.

Tri de la liste de discussions

Vous pouvez choisir comment trier la liste des discussions.

  1. Sur GitHub, naviguez vers la page principale du référentiel ou de l’organisation.

  2. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions.

    Capture d’écran des onglets d’un dépôt GitHub. L’option « Discussions » est présentée en orange foncé.

  3. À droite du champ Rechercher dans toutes les discussions, sélectionnez le menu déroulant Trier par, puis cliquez sur une période de temps.

    Capture d’écran d’une ligne de boutons pour trier les discussions. Un bouton intitulé « Trier par : Activité la plus récente » est mis en surbrillance avec un contour orange.

    • Triez par Dernière activité pour afficher les discussions avec l’activité la plus récente en haut de la liste.
    • Triez par Date de création pour afficher les discussions qui ont été créées récemment en haut de la liste.
    • Trier par Top pour afficher les discussions avec le plus de votes en haut de la liste. Vous pouvez limiter la liste pour afficher uniquement les discussions d’une période spécifique.

Tri des commentaires de niveau supérieur dans les discussions

Vous pouvez choisir comment trier les commentaires de niveau supérieur dans les discussions. Les threads de commentaires n’ont pas d’impact sur l’ordre dans lequel les commentaires sont triés.

  1. Sur GitHub, naviguez vers la page principale du référentiel ou de l’organisation.

  2. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions.

    Capture d’écran des onglets d’un dépôt GitHub. L’option « Discussions » est présentée en orange foncé.

  3. Dans la liste des discussions, cliquez sur la discussion à afficher.

  4. Sous le message de discussion principal, sélectionnez Plus ancien, Plus récent ou Top.

    Capture d’écran d’une discussion. Les boutons permettant de trier les commentaires dans les discussions sont indiqués en orange foncé.

    • Triez par Plus ancien pour afficher d’abord les commentaires de niveau supérieur les plus anciens.
    • Triez selon Plus récent pour afficher d’abord les commentaires de niveau supérieur les plus récents.
    • Triez par Top pour afficher d’abord les commentaires de niveau supérieur les plus votés.

Conversion d’un problème en discussion

Si un problème s'avère être une question ou une conversation ouverte plutôt qu'un élément de travail à suivre et à prioriser, vous pouvez convertir le problème en discussion. Pour plus d’informations, consultez « Modération de discussions ».

Pour aller plus loin