Skip to content

Instantly share code, notes, and snippets.

@jeanniardJ
Created October 15, 2023 10:15
Show Gist options
  • Save jeanniardJ/4afd62cfba6b48a2fc551d88aa506e27 to your computer and use it in GitHub Desktop.
Save jeanniardJ/4afd62cfba6b48a2fc551d88aa506e27 to your computer and use it in GitHub Desktop.
Bonnes Pratiques pour les Issues sur GitHub

Gérer les issues de manière efficace sur GitHub peut grandement contribuer à la réussite d'un projet. Voici quelques bonnes pratiques :

1. Titre des Issues

  • Utilisez un titre descriptif et concis qui reflète clairement le problème ou la fonctionnalité.
  • Exemple : "Erreur lors de la soumission du formulaire de contact".

2. Description

  • Fournissez une description détaillée du problème ou de la fonctionnalité proposée.
  • Incluez les étapes pour reproduire le problème, si applicable.
  • Ajoutez des captures d'écran ou des vidéos si elles peuvent aider à illustrer le problème.

3. Labels

  • Utilisez des labels pour catégoriser et prioriser les issues.
  • Exemple : "bug", "enhancement", "good first issue".

4. Milestones

  • Associez les issues à des milestones pour suivre le progrès du projet.

5. Assignation

  • Assignez les issues aux membres de l'équipe qui travailleront dessus.

6. Référence

  • Référencez d'autres issues ou pull requests liées en utilisant # suivi du numéro de l'issue.
  • Exemple : "Relié à #123".

7. Utilisation de Templates

  • Créez des templates d'issues pour encourager la cohérence dans la façon dont les problèmes et les demandes de fonctionnalités sont rapportés.

8. Garder les Discussions Focalisées

  • Gardez les discussions dans les issues centrées sur le sujet initial pour éviter la confusion.

9. Fermer les Issues Résolues

  • Fermez les issues une fois qu'elles ont été résolues, et assurez-vous d'ajouter un commentaire expliquant la résolution.

10. Lien vers la Documentation

  • Si une issue est résolue par une mise à jour de la documentation, assurez-vous d'inclure un lien vers la page de documentation pertinente.

11. Évitez les Doublons

  • Recherchez des issues existantes avant d'en créer une nouvelle pour éviter les doublons.

12. Utilisation de Projets

  • Utilisez la fonctionnalité "Projects" de GitHub pour organiser et prioriser les issues dans un format Kanban.

En suivant ces bonnes pratiques, vous pouvez maintenir un suivi des issues propre, organisé, et efficace, ce qui est crucial pour la gestion réussie d'un projet sur GitHub.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment