Introduction
GitHub Enterprise Server fournit des outils de communication collaboratifs intégrés qui vous permettent de d’interagir étroitement avec votre communauté. Ce guide de démarrage rapide vous montre comment choisir l’outil approprié à vos besoins.
Vous pouvez créer des problèmes, demandes de tirage (pull requests), GitHub Discussions et discussions d’équipe afin d’y participer, selon le type de conversation souhaité.
GitHub Issues
- S’avèrent utiles pour discuter des détails spécifiques d’un projet, comme les rapports de bogues, les améliorations planifiées et les commentaires
- Sont propres à un dépôt et ont généralement un propriétaire clairement désigné
- Sont souvent désignés comme le système de suivi des bogues de GitHub
Requêtes de tirage
- Vous permettent de proposer des modifications spécifiques
- Vous permettent de commenter directement les modifications proposées et suggérées par d’autres personnes
- Sont propres à un référentiel
Discussions d’équipe
- Peuvent être lancées à partir de la page de votre équipe pour des conversations qui s’étendent à plusieurs projets et qui ne relèvent pas d’un problème ou d’une demande de tirage spécifique. Au lieu d’ouvrir un problème dans un dépôt pour discuter d’une idée, vous pouvez inclure toute l’équipe en menant une conversation dans une discussion d’équipe.
- Vous permettent d'avoir des discussions avec votre équipe à propos de la planification, l'analyse, la conception, la recherche utilisateur et la prise de décision générale du projet depuis un seul emplacement.
- Offrent une expérience collaborative en dehors du codebase, propice aux séances de concertation.
- N’ont souvent aucun propriétaire clairement désigné.
- N’entraînent souvent aucune tâche actionnable.
Quel outil de discussion dois-je utiliser ?
Scénarios pour les problèmes
- Je veux garder une trace des tâches, améliorations et bogues.
- Je veux classer un rapport de bogue.
- Je veux partager des commentaires sur une fonctionnalité spécifique.
- Je veux poser une question sur des fichiers du dépôt.
Exemple de problème
Cet exemple montre comment un utilisateur GitHub a créé un problème dans le dépôt open source de notre documentation pour nous faire part d’un bogue et discuter d’un correctif.
- Un utilisateur a remarqué que la couleur bleue de la bannière située en haut de la page dans la version chinoise de GitHub Docs rend le texte qu’elle contient illisible.
- Cet utilisateur a créé un problème dans le dépôt, en le décrivant et en suggérant un correctif (à savoir, utiliser une autre couleur d’arrière-plan pour la bannière).
- Une discussion s’ensuit, pour finalement parvenir à un consensus sur le correctif à appliquer.
- Un contributeur peut alors créer une demande de tirage (pull request) avec le correctif.
Scénarios pour les demandes de tirage (pull requests)
- Je veux corriger une faute de frappe dans un dépôt.
- Je veux apporter des modifications à un dépôt.
- Je veux apporter des modifications pour corriger un problème.
- Je veux commenter des modifications suggérées par d’autres personnes.
Exemple de requête de tirage
Cet exemple montre comment un utilisateur GitHub a créé une demande de tirage (pull request) dans le dépôt open source de notre documentation pour corriger une faute de frappe.
Sous l’onglet Conversation de la demande de tirage, l’auteur explique pourquoi il a créé la demande de tirage.
L’onglet Fichiers modifiés de la demande de tirage présente le correctif implémenté.
- Ce contributeur remarque une faute de frappe dans le dépôt.
- L’utilisateur crée une demande de tirage avec le correctif.
- Un gestionnaire de dépôt passe en revue la demande de tirage et les commentaires s’y rapportant, puis il la fusionne.
Scénarios pour GitHub Discussions
- J’ai une question qui n’est pas nécessairement liée à des fichiers spécifiques du dépôt.
- Je veux diffuser des nouvelles à mes collaborateurs ou mon équipe.
- Je veux participer à une conversation ouverte ou en démarrer une.
- Je veux faire une annonce à ma communauté.
Exemple de GitHub Discussions
Cet exemple montre le billet d’accueil GitHub Discussions pour le dépôt open source GitHub Docs et illustre la façon dont l’équipe souhaite collaborer avec sa communauté.
Ce gestionnaire de la communauté a démarré une discussion pour accueillir la communauté et demander à ses membres de se présenter. Ce billet crée une atmosphère accueillante pour les visiteurs et les contributeurs. Il établit également que l’équipe est ravie de soutenir les contributions apportées au dépôt.
Scénarios pour les discussions d’équipe
- J’ai une question qui n’est pas nécessairement liée à des fichiers spécifiques du dépôt.
- Je veux diffuser des nouvelles à mes collaborateurs ou mon équipe.
- Je veux participer à une conversation ouverte ou en démarrer une.
- Je veux faire une annonce à mon équipe.
Exemple de discussion d’équipe
Cet exemple illustre un billet de l’équipe octo-team.
Le membre octocat de l’équipe a publié une discussion d’équipe, afin d’informer l’équipe de diverses choses :
- Un membre de l’équipe appelé Mona a lancé des événements de jeu à distance.
- Il existe un billet de blog qui décrit la manière dont les équipes utilisent GitHub Actions pour produire leurs documents.
- Les documents liés à l’événement April All Hands sont désormais mis à la disposition de tous les membres de l’équipe.
Étapes suivantes
Ces exemples vous ont montré comment déterminer l’outil le mieux approprié à vos conversations sur GitHub Enterprise Server. Mais ce n’est qu’un début ; il y a tant d’autres choses que vous pouvez faire pour adapter ces outils à vos besoins.
Pour les problèmes, par exemple, vous pouvez utiliser des étiquettes à des fins de recherche plus rapide et créer des modèles de problème pour aider les contributeurs à ouvrir des problèmes pertinents. Pour plus d’informations, consultez « À propos des problèmes » et « À propos des modèles de problème et de demande de tirage ».
Pour les demandes de tirage, vous pouvez créer des brouillons si les modifications que vous proposez sont encore en cours de travail. Les brouillons de demande de tirage ne peuvent pas être fusionnés tant qu’ils ne sont pas marqués comme étant prêts pour la révision. Pour plus d’informations, consultez « À propos des demandes de tirage (pull requests) ».
Pour les GitHub Discussions, vous pouvez épingler des discussions qui contiennent des informations importantes pour votre communauté. Pour plus d’informations, consultez « À propos des discussions ».
Pour les discussions d’équipe, vous pouvez modifier ou supprimer des discussions dans la page d’une équipe et configurer des notifications pour les discussions d’équipe. Pour plus d’informations, consultez « À propos des discussions d’équipe ».
Pour découvrir certaines fonctionnalités de mise en forme avancées qui vous aideront à communiquer, consultez « Démarrage rapide pour l'écriture sur GitHub ».