Refondre GitHub Basics autour du parcours GitHub Skills contextuel

Author: lilblueyes

.github/steps/1-create-a-branch.md

@@ -0,0 +1,56 @@
+## É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 :
+
+```text
+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**.
+
+   ![Onglet Code](../images/code-tab-highlight.png)
+
+3. Ouvre le menu qui affiche actuellement `main`.
+
+   <img width="300" alt="Sélecteur de branche GitHub" src="../images/branch-selection-dropdown.png">
+
+4. Dans **Find or create a branch...**, saisis exactement `my-first-branch`.
+5. Clique sur **Create branch: my-first-branch from main**.
+
+   <img width="300" alt="Création de la branche my-first-branch" src="../images/create-branch-prompt.png">
+
+GitHub bascule automatiquement sur la nouvelle branche.
+
+> [!IMPORTANT]
+> Le nom `my-first-branch` est utilisé par l'automatisation du cours. Utilise exactement ce nom.
+
+<details>
+<summary>Option terminal, si tu travailles déjà avec une copie locale du dépôt</summary>
+
+```bash
+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.
+
+</details>
+
+Une fois la branche créée sur GitHub, Mona détectera l'action et publiera automatiquement l'étape suivante ici.

.github/steps/1-step.md

@@ -0,0 +1,76 @@
+## É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**.
+
+   <img width="300" alt="Créer un nouveau fichier dans GitHub" src="../images/create-new-file-option.png">
+
+3. Dans **Name your file...**, saisis :
+
+   ```text
+   PROFILE.md
+   ```
+
+4. Dans le fichier, écris au minimum :
+
+   ```markdown
+   # Mon profil
+
+   Hello GitHub !
+
+   Je découvre les branches, les commits et la collaboration sur GitHub.
+   ```
+
+   ![Éditeur GitHub contenant PROFILE.md](../images/add-profile-file.png)
+
+5. Clique sur **Commit changes...**.
+6. Dans **Commit message**, écris exactement :
+
+   ```text
+   Ajouter PROFILE.md
+   ```
+
+   <img width="400" alt="Boîte de dialogue du message de commit" src="../images/commit-message-dialog.png">
+
+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`.
+
+<details>
+<summary>Option terminal</summary>
+
+```bash
+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.
+
+</details>
+
+Dès que GitHub reçoit ce commit sur `my-first-branch`, Mona vérifie ton travail puis affiche l'étape suivante.

.github/steps/2-commit-a-file.md

@@ -0,0 +1,67 @@
+## É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** :
+
+![Bouton Compare & pull request](../images/compare-pull-request-button.png)
+
+Tu peux cliquer dessus. Sinon, utilise directement :
+
+[**Créer ma pull request →**](../../compare/main...my-first-branch?expand=1)
+
+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`
+
+   ![Choix des branches d'une pull request](../images/branch-selection-comparison.png)
+
+4. Clique sur **Create pull request**.
+
+### Donner du contexte aux autres
+
+Une PR doit expliquer ce qu'elle propose.
+
+Utilise exactement ce titre :
+
+```text
+Ajouter mon profil
+```
+
+Puis ajoute une courte description, par exemple :
+
+```markdown
+## Description
+
+J'ai ajouté PROFILE.md afin de pratiquer mon premier cycle de contribution sur GitHub.
+```
+
+![Formulaire de création d'une pull request](../images/create-pull-request-form.png)
+
+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.