Exercice : GitHub Basics

[github-actions]

GitHub Basics

👋 Salut @lilblueyes ! Bienvenue dans cet exercice interactif.

Tu vas découvrir GitHub en pratiquant : d'abord dans l'Issue du cours, puis directement dans la conversation de ta pull request.

---

✨ Le cours va te guider là où tu travailles.

Au début, cette Issue sert de fil conducteur. À chaque étape, le bot vérifie ton action puis publie la suite.

Quand tu ouvriras une pull request, c'est-à-dire l'espace GitHub où l'on propose et relit un changement avant de l'intégrer, la suite apparaîtra directement dans sa conversation. Tu n'auras donc pas à revenir sans cesse dans cette Issue.

Tu peux garder cette page ouverte comme journal de progression, mais suis simplement les messages du bot au fur et à mesure.

C'est parti !

_{— Mona}

_{Si tu rencontres un problème avec l'exercice, tu peux le signaler ici.}

[github-actions]

Étape 1 : créer une branche

Bienvenue dans ta première manipulation GitHub.

Un dépôt et sa branche principale

Le dépôt est le projet que tu viens de créer à partir du template. GitHub y stocke les fichiers et leur historique.

Un dépôt peut avoir plusieurs branches. Une branche est une version parallèle du projet : elle permet de préparer un changement sans modifier immédiatement la version de référence.

Dans ce dépôt, la branche de référence s'appelle main.

Pourquoi créer une branche ?

Imagine main comme la version actuellement validée du projet. Pour essayer une modification, on travaille généralement ailleurs puis on décide plus tard si cette modification doit rejoindre main.

Pour cet exercice, tu vas créer :

my-first-branch

Activité : créer my-first-branch

1. Ouvre la page principale du dépôt dans un nouvel onglet.

2. Vérifie que tu es dans l'onglet Code.

   

3. Ouvre le menu qui affiche actuellement main.

   

4. Dans Find or create a branch..., saisis exactement my-first-branch.

5. Clique sur Create branch: my-first-branch from main.

   

GitHub bascule automatiquement sur la nouvelle branche.

Important

Le nom my-first-branch est utilisé par l'automatisation du cours. Utilise exactement ce nom.

Option terminal, si tu travailles déjà avec une copie locale du dépôt

git switch -c my-first-branch
git push -u origin my-first-branch

git switch -c crée la branche et s'y place. git push envoie cette branche vers GitHub.

Une fois la branche créée sur GitHub, Mona détectera l'action et publiera automatiquement l'étape suivante ici.

[github-actions]

Suis les instructions ci-dessus.

Je surveille automatiquement ta progression pour te donner du feedback et afficher la suite. 🧐

[github-actions]

🎉 Bien joué, cette étape est validée !

Je prépare l'étape 2. 🤓

[github-actions]

Étape 2 : créer un fichier et ton premier commit

Ta branche existe maintenant. Tu peux y modifier le projet sans changer main.

Qu'est-ce qu'un fichier Markdown ?

Tu vas créer PROFILE.md. L'extension .md indique un fichier Markdown, un format texte simple utilisé partout sur GitHub pour écrire des README, de la documentation et des commentaires structurés.

Qu'est-ce qu'un commit ?

Un commit est un point enregistré dans l'historique Git.

Il contient notamment :

• les modifications enregistrées ;
• leur auteur ;
• leur date ;
• un message de commit qui résume ce qui a changé.

Un message clair rend l'historique compréhensible pour toi et pour les autres contributeurs.

Activité : créer PROFILE.md

1. Dans l'onglet Code, vérifie que la branche affichée est bien my-first-branch.

2. Clique sur Add file, puis Create new file.

   

3. Dans Name your file..., saisis :

   PROFILE.md
   

4. Dans le fichier, écris au minimum :

   # Mon profil
   
   Hello GitHub !
   
   Je découvre les branches, les commits et la collaboration sur GitHub.

   

5. Clique sur Commit changes....

6. Dans Commit message, écris exactement :

   Ajouter PROFILE.md
   

   

7. Confirme avec Commit changes.

Important

Le cours vérifiera trois choses : que PROFILE.md existe, qu'il contient le mot Hello, et que le message du commit contient Ajouter PROFILE.md.

Option terminal

git switch my-first-branch
printf "# Mon profil\n\nHello GitHub !\n" > PROFILE.md
git add PROFILE.md
git commit -m "Ajouter PROFILE.md"
git push

Ici, git add prépare le fichier pour le prochain commit, git commit crée le commit, puis git push envoie ce nouveau commit vers GitHub.

Dès que GitHub reçoit ce commit sur my-first-branch, Mona vérifie ton travail puis affiche l'étape suivante.

[github-actions]

Étape 2 validée ✅

Statut	Vérification
✅ Validé	Le fichier PROFILE.md existe
✅ Validé	PROFILE.md contient le mot Hello
✅ Validé	Le message du commit contient Ajouter PROFILE.md

[github-actions]

🎉 Bien joué, cette étape est validée !

Je prépare l'étape 3. 🤓

[github-actions]

Étape 3 : ouvrir une pull request

Ta branche contient maintenant un changement qui n'existe pas dans main.

Qu'est-ce qu'une pull request ?

Une pull request, souvent abrégée PR, est une proposition de changement.

Elle compare :

• une branche base, ici main, qui est la destination ;
• une branche compare, ici my-first-branch, qui contient ton travail.

Ouvrir une pull request ne modifie pas encore main. Tu demandes simplement : « voici mon changement, peut-on l'intégrer ? »

Activité : créer ta pull request

Après ton commit, GitHub peut afficher Compare & pull request :

Tu peux cliquer dessus. Sinon, utilise directement :

Créer ma pull request →

Si tu passes par l'interface manuelle :

1. ouvre l'onglet Pull requests ;

2. clique sur New pull request ;

3. choisis :

   • base : main
   • compare : my-first-branch

   

4. Clique sur Create pull request.

Donner du contexte aux autres

Une PR doit expliquer ce qu'elle propose.

Utilise exactement ce titre :

Ajouter mon profil

Puis ajoute une courte description, par exemple :

## Description

J'ai ajouté PROFILE.md afin de pratiquer mon premier cycle de contribution sur GitHub.

Clique enfin sur Create pull request.

Important

Mona vérifiera le titre et la présence d'une description.

Ensuite, reste dans la pull request

Une fois la PR créée, ne reviens pas ici pour chercher la suite.

Reste dans l'onglet Conversation de ta pull request. Le bot GitHub Actions y vérifiera ton travail et y publiera directement l'étape suivante.

[github-actions]

✅ Ta pull request #4 est valide. La suite du cours se déroule maintenant directement dans sa Conversation.

[github-actions]

Félicitations @lilblueyes ! Tu as terminé l'exercice 🎉🎉🎉

Le dépôt a été mis à jour pour marquer ta réussite.

Retourne sur la page d'accueil du dépôt pour voir le résultat.