📘 Chapitre – Utiliser GitHub Desktop & gérer des issues

1. 🎯 Objectif pédagogique

Apprendre à utiliser GitHub Desktop pour gérer les dépôts sans ligne de commande, et comprendre l’utilisation des issues pour organiser le suivi des tâches et corrections.

2. 📚 Concepts abordés

  • Installation et configuration de GitHub Desktop
  • Cloner, commiter et pousser des changements via l’interface graphique
  • Création et gestion des issues sur GitHub
  • Assignation, labels et milestones pour le suivi des tâches
  • Bonne pratique : relier un commit à une issue (#ID)

3. 🧠 Explication théorique

GitHub Desktop

C’est une application graphique officielle qui simplifie les opérations Git. Elle permet de :

  • Cloner un dépôt distant en 1 clic.
  • Suivre les changements de fichiers (staging).
  • Créer des commits et pousser sur GitHub.

Issues sur GitHub

Les issues servent à signaler un bug, demander une nouvelle fonctionnalité ou organiser une tâche.

  • Labels : pour catégoriser (ex : bug, enhancement).
  • Milestones : pour planifier les livrables.
  • Assignation : attribuer l’issue à un membre.

Exemple d’utilisation :

  • Issue #5 : « Corriger le bug d’affichage du formulaire. »
  • Commit lié : git commit -m "Fix formulaire #5" (cela ferme l’issue #5 une fois le commit poussé).

4. 🛠 Tutoriel pratique

Résumé du travail : Utiliser GitHub Desktop pour commiter et gérer une issue sur GitHub.

Étape 1 : Installer GitHub Desktop

Étape 2 : Cloner un dépôt

  • File > Clone repository.
  • Choisir le dépôt à cloner depuis votre compte.

Étape 3 : Faire un commit graphique

  1. Modifier un fichier dans le projet.
  2. GitHub Desktop détecte la modification.
  3. Ajouter un message de commit.
  4. Cliquer sur Commit to main puis Push origin.

Étape 4 : Créer une issue sur GitHub

  1. Aller dans l’onglet Issues du dépôt.
  2. Cliquer New issue.
  3. Donner un titre (ex. « Ajouter une page d’accueil ») et une description.
  4. Assigner l’issue et ajouter un label (bug/feature).

Étape 5 : Lier un commit à une issue

Dans GitHub Desktop, mettre un message :

Ajout page d’accueil #1

Cela reliera le commit à l’issue #1.

5. 🧾 Résumé et points-clés

  • GitHub Desktop facilite l’utilisation de Git pour les débutants.
  • Les issues permettent un suivi des tâches, bugs et améliorations.
  • Utiliser des labels et milestones pour organiser les projets.
  • Mentionner #numéro dans un commit pour lier directement à une issue.