Exercice : GitHub Basics

[github-actions]

GitHub Basics

👋 Salut @lilblueyes ! Bienvenue dans cet exercice interactif.

Tu vas apprendre les bases de GitHub en réalisant une petite modification guidée. Chaque notion sera expliquée juste avant sa première utilisation.

---

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

Cette page est une Issue, c'est-à-dire un fil de suivi GitHub utilisé pour discuter d'une tâche, d'un problème ou d'un objectif. Dans ce cours, elle sert de journal de progression.

Au début, les premières étapes apparaîtront ici. À 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.

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 dépôt modèle. 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.

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.

GitHub sait afficher le texte Markdown sous une forme mise en page. Avant d'enregistrer ton fichier, tu vas donc comparer le texte que tu écris avec son rendu.

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é.

À la base, ce message se rédige à la main : il doit être court, clair et décrire l'intention du changement.

Note

Sur GitHub.com, si GitHub Copilot est disponible sur ton compte, GitHub peut aujourd'hui proposer automatiquement un résumé et une description lorsque tu cliques sur Commit changes.... Relis toujours cette proposition et modifie-la si nécessaire avant de valider. Si aucune suggestion n'apparaît, écris simplement le message toi-même. La génération automatique peut notamment te proposer un message en anglais.

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 Preview au-dessus de l'éditeur et observe comment GitHub rend le Markdown.

6. Reviens dans l'éditeur si tu veux corriger quelque chose, puis clique sur Commit changes....

7. Vérifie le message de commit :

   • soit tu écris toi-même un message clair, par exemple Ajouter PROFILE.md ;
   • soit GitHub Copilot t'en propose un : lis-le et adapte-le si nécessaire.

8. Confirme avec Commit changes.

Important

Le cours vérifiera que PROFILE.md existe et qu'il contient le mot Hello. Le texte exact de ton message de commit n'est pas imposé : l'objectif est qu'il décrive clairement le changement.

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

[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 bonne PR permet de comprendre le changement sans devoir deviner son intention.

Choisis un titre court et explicite, par exemple :

Ajouter mon profil

ou :

Add PROFILE.md

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 que le titre est suffisamment explicite et qu'une description est présente. Tu n'as plus de phrase exacte à recopier.

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 #3 est valide. La suite du cours se déroule maintenant directement dans sa Conversation.

[github-actions]

Félicitations @github-actions[bot] ! 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.