GitHub est une plateforme collaborative

  • 8 minutes

La collaboration est au cœur de tout ce que fait GitHub. Nous avons vu les dépôts dans la première unité du module, et appris qu’ils vous aident à organiser votre projet et ses fichiers. Dans la dernière unité, nous avons appris à connaître les demandes d’extraction (pull requests), qui sont un moyen de suivre les modifications apportées à votre projet.

Dans cette unité, nous apprenons sur les problèmes et les discussions. Ce sont deux autres éléments qui contribuent à la nature collaborative de la plateforme GitHub Enterprise.

Problèmes

Les problèmes GitHub ont été créés pour suivre les idées, les commentaires, les tâches ou les bogues à travailler dans GitHub. Les problèmes peuvent être créés de différentes manières et vous pouvez choisir la méthode qui convient le mieux à votre workflow.

Pour cette procédure pas à pas, nous allons découvrir comment créer un problème à partir d’un référentiel. Toutefois, les problèmes peuvent également être créés à partir des points suivants :

  • Un élément de liste de tâches.
  • Une note dans un projet.
  • Un commentaire dans un problème ou une demande de tirage.
  • Une ligne de code spécifique.
  • Une requête d’URL.

Création d’un problème à partir d’un dépôt

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

  2. Sous le nom de votre référentiel, sélectionnez Problèmes.

    Capture d’écran montrant la partie supérieure de la page principale d’un référentiel avec la section Problèmes mise en surbrillance.

  3. Sélectionnez Nouveau problème.

  4. Si votre référentiel utilise des modèles de problèmes, sélectionnez Démarrage à côté du type de problème que vous souhaitez ouvrir.

    Si le type de problème que vous souhaitez ouvrir ne figure pas dans les options disponibles, sélectionnez Ouvrir un problème vide. Si vous n’utilisez pas de modèles, passez à l’étape 5.

    Une capture d’écran du menu Modèles de problème, avec l’option Ouvrir un problème vide mise en surbrillance.

  5. Dans le champ Ajouter un titre, entrez un titre pour votre problème.

  6. Dans le champ Ajouter une description, tapez la description de votre problème.

  7. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un tableau de projet, l’associer à un jalon ou appliquer une étiquette.

  8. Une fois terminé, sélectionnez Soumettre un problème.

Certaines conversations sont plus adaptées à GitHub Discussions. Vous pouvez utiliser GitHub Discussions pour poser des questions ou y répondre, partager des informations, faire des annonces, et lancer ou rejoindre des conversations sur un projet.

Dans la section suivante, nous passons en revue la fonctionnalité Discussions et comment l’utiliser au mieux.

Discussions

Les discussions concernent les conversations qui doivent être accessibles à tout le monde et qui ne sont pas liées au code. Les discussions permettent une conversation fluide et ouverte dans un forum public.

Dans cette section, nous passons en revue :

  • Activation d’une discussion dans votre référentiel.
  • Création d’une discussion et de différentes catégories de discussion.

Voyons comment activer une discussion dans votre dépôt.

Activation d’une discussion dans votre dépôt

Les propriétaires de dépôt et les personnes qui ont 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.

La première fois que vous activez GitHub Discussions, vous êtes invité à configurer un billet de bienvenue.

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

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

    Une capture d’écran de la partie supérieure de la page principale d’un référentiel avec la section Paramètres en surbrillance.

  3. Faites défiler vers le bas de l’écran jusqu’à la section Fonctionnalitéset, sous Discussions, sélectionnez Configurer des discussions.

    Une capture d’écran de la zone Discussions avec le bouton de discussion de configuration verte mis en surbrillance.

  4. Sous Démarrer une discussion, modifiez le modèle à aligner sur les ressources et le ton que vous souhaitez définir pour votre communauté.

  5. Sélectionnez Démarrer une discussion.

Vous êtes maintenant prêt à créer une discussion.

Créer 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 dépôt ou de l’organisation dans laquelle vous voulez commencer une discussion.

  2. Sous le nom de votre référentiel ou organisation,sélectionnez Discussions.

    Une capture d’écran de la partie supérieure de la page principale d’un référentiel avec la section Discussions en surbrillance.

  3. Sur le côté droit de la page, sélectionnez Nouvelle discussion.

  4. Sélectionnez une catégorie de discussion en sélectionnant Démarrage. 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.

    Une capture d’écran de la sélection d’une sélection de menu de catégorie de discussion, avec l’option Annonces en haut et le bouton Prise en main mis en surbrillance.

Chaque catégorie doit être associée à un nom unique, un emoji, et à une description détaillée indiquant son objectif. Les groupes d’aide à la maintenance organisent la façon dont les conversations sont déposées. Ils sont personnalisables pour aider à distinguer les catégories qui sont des conversations Q&A ou plus ouvertes. Le tableau suivant montre les catégories de discussions par défaut et leur objectif.

Catégorie Objectif Format
Annonces 📣 Mises à jour et actualités des responsables de la maintenance Annonce
#️⃣ General Tout ce qui est pertinent pour le projet Discussion ouverte
💡 Idées Idées pour changer ou améliorer le projet Discussion ouverte
🗳 Sondages Sondages avec plusieurs options de vote et de discussion pour la communauté Sondages
🙏 Questions et réponses Questions auxquelles la communauté doit répondre, sous forme de questions/réponses Question et réponse
🙌 Montrer et expliquer Créations, expériences ou tests pertinents pour le projet Discussion ouverte

  1. Sous Titre de la discussion, entrez un titre pour votre discussion et, sous Écrire, entrez le corps de votre discussion.

    Une capture d’écran du démarrage d’une nouvelle page de discussion avec la zone de titre discussion et la zone de contenu vides.

  2. Sélectionnez Démarrer une discussion.

Cela décrit un peu la façon dont GitHub inspire la collaboration. Voyons maintenant comment gérer les notifications, s’abonner aux threads et commencer à utiliser des pages GitHub.