La collaboration est au cœur de tout ce que fait GitHub. Nous avons abordé les dépôts dans la première unité du module et appris qu’ils permettent d’organiser votre projet et ses fichiers. Dans la dernière unité, nous avons découvert les pull requests, qui permettent de suivre les modifications apportées à un projet.

Dans cette unité, nous allons apprendre ce que sont les issues (problèmes) et les discussions. Ce sont deux autres éléments qui renforcent la nature collaborative de la plateforme GitHub Enterprise.

Issues

Les issues GitHub ont été créées pour suivre des idées, des retours, des tâches ou des bugs liés au travail sur GitHub. Elles peuvent être créées de différentes manières, ce qui vous permet de choisir la méthode la plus adaptée à votre flux de travail.

Dans cette démonstration, nous allons voir comment créer une issue à partir d’un dépôt. Mais il est aussi possible de créer une issue à partir de :

• Un élément dans une liste de tâches
• Une note dans un projet
• Un commentaire dans une issue ou une pull request
• Une ligne de code spécifique
• Une requête URL

Créer une issue à partir d’un dépôt

• Sur GitHub.com, accédez à la page principale du dépôt.
• Sous le nom de votre dépôt, sélectionnez Issues.

Sélectionnez « New issue » (Nouvelle issue).

• Si votre dépôt utilise des modèles d’issues, à côté du type d’issue que vous souhaitez ouvrir, selectionnez « Get started » (Commencer).

• Si le type d’issue que vous souhaitez ouvrir ne figure pas parmi les options disponibles, sélectionnez « Open a blank issue » (Ouvrir une issue vierge).
• Si vous n’utilisez pas de modèles, passez directement à l’étape 5.

• Dans le champ « Add a title », saisissez un titre pour votre issue.
• Dans le champ « Add a description », tapez une description de votre issue.
• Si vous êtes responsable du projet, vous pouvez assigner l’issue à quelqu’un, l’ajouter à un tableau de projet, l’associer à une étape importante (milestone) ou appliquer une étiquette (label).

Une fois terminé, sélectionnez « Submit new issue » (Soumettre une nouvelle issue).

Certaines conversations conviennent mieux aux Discussions GitHub. Vous pouvez utiliser les Discussions pour poser et répondre à des questions, partager des informations, faire des annonces et mener ou participer à des conversations autour d’un projet.

Discussions

Les discussions sont destinées aux conversations qui doivent être accessibles à tous et qui ne sont pas directement liées au code. Elles permettent une conversation fluide et ouverte dans un forum public.

Dans cette section, nous allons aborder :

• L’activation des discussions dans votre dépôt
• La création d’une nouvelle discussion et les différentes catégories de discussion

Plongeons dans l’activation des discussions dans votre dépôt.

Activer les discussions dans votre dépôt

Les propriétaires de dépôt et les personnes ayant un accès en écriture peuvent activer les Discussions GitHub 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 elle est créée.

Lorsque vous activez les Discussions GitHub pour la première fois, vous êtes invité à configurer un message de bienvenue.

• Sur GitHub.com, accédez à la page principale du dépôt.

• Sous le nom de votre dépôt, sélectionnez Settings (Paramètres).

• Faites défiler jusqu’à la section « Features » (Fonctionnalités), puis sous « Discussions », sélectionnez « Setup discussions » (Configurer les discussions).

• Sous « Start a new discussion » (Démarrer une nouvelle discussion), modifiez le modèle pour qu’il corresponde aux ressources et au ton que vous souhaitez établir pour votre communauté.
• Sélectionnez « Start discussion » (Démarrer la discussion).

Vous êtes maintenant prêt(e) à créer une nouvelle discussion.

• Sur le côté droit de la page, sélectionnez « New discussion » (Nouvelle discussion).
• Sélectionnez une catégorie de discussion en cliquant sur « Get started » (Commencer).
  Toutes les discussions doivent être créées dans une catégorie.
  Pour les discussions d’un dépôt, les personnes ayant les permissions de maintenance ou d’administration définissent les catégories de discussion dans ce dépôt.

Créer une nouvelle discussion

• Tout utilisateur authentifié pouvant voir le dépôt peut créer une discussion dans ce dépôt. De même, puisque les discussions d’une organisation sont basées sur un dépôt source, tout utilisateur authentifié pouvant voir le dépôt source peut créer une discussion dans cette organisation.
• Sur GitHub.com, accédez à la page principale du dépôt ou de l’organisation où vous souhaitez démarrer une discussion.

Sous le nom de votre dépôt ou de votre organisation, sélectionnez Discussions

Chaque catégorie doit avoir un nom unique, une association avec un emoji, et une description détaillée précisant son objectif.
Les catégories aident les responsables du dépôt à organiser la manière dont les conversations sont classées.
Elles sont personnalisables pour permettre de distinguer les catégories destinées aux questions-réponses (Q&R) ou aux conversations plus ouvertes.

Le tableau suivant présente les catégories par défaut pour les discussions ainsi que leur objectif.

Catégorie	Objectif	Format
📣 Annonces	Mises à jour et actualités des responsables du projet	Annonce
#️⃣ Général	Tout ce qui est pertinent au projet, de manière générale	Discussion ouverte
💡 Idées	Propositions pour modifier ou améliorer le projet	Discussion ouverte
🗳️ Sondages	Sondages avec plusieurs options pour que la communauté vote et discute	Sondage
🙏 Questions/Réponses	Questions posées à la communauté, avec un format question/réponse	Question et réponse
🙌 Présentations	Créations, expériences ou tests en lien avec le projet	Discussion ouverte

Sous « Discussion title » (Titre de la discussion), saisissez un titre pour votre discussion,
et sous « Write » (Écrire), saisissez le corps de votre discussion.

• Sélectionnez « Start discussion » (Démarrer la discussion).

Cela conclut une brève présentation de la manière dont GitHub favorise la collaboration.
Passons maintenant à la façon dont vous pouvez gérer les notifications, vous abonner à des fils de discussion, et commencer avec GitHub Pages.