From f8490121517e9ef5c2ada5c75650b63468962bd1 Mon Sep 17 00:00:00 2001
From: Jocelyn Deleuil <101664783+lilblueyes@users.noreply.github.com>
Date: Fri, 25 Sep 2026 16:58:33 +0200
Subject: [PATCH 1/4] =?UTF-8?q?Pr=C3=A9parer=20le=20test=20propre=20du=20t?=
=?UTF-8?q?utoriel=20GitHub=20Basics?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/workflows/reset-fresh-test.yml | 36 ++++++++++++++++++++++++++
1 file changed, 36 insertions(+)
create mode 100644 .github/workflows/reset-fresh-test.yml
diff --git a/.github/workflows/reset-fresh-test.yml b/.github/workflows/reset-fresh-test.yml
new file mode 100644
index 0000000..bd4f12d
--- /dev/null
+++ b/.github/workflows/reset-fresh-test.yml
@@ -0,0 +1,36 @@
+name: Préparer un test propre GitHub Basics
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - ".github/workflows/reset-fresh-test.yml"
+
+permissions:
+ actions: write
+ contents: write
+
+jobs:
+ reset:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Nettoyer les branches et réactiver Step 0
+ env:
+ GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ run: |
+ set -euo pipefail
+
+ gh api --method DELETE "repos/${GITHUB_REPOSITORY}/git/refs/heads/my-first-branch" || true
+
+ for workflow in 1-create-a-branch.yml 2-commit-a-file.yml 3-open-a-pull-request.yml 4-merge-your-pull-request.yml; do
+ state="$(gh api "repos/${GITHUB_REPOSITORY}/actions/workflows/$workflow" --jq '.state' 2>/dev/null || true)"
+ if [ "$state" = "active" ]; then
+ gh api --method PUT "repos/${GITHUB_REPOSITORY}/actions/workflows/$workflow/disable"
+ fi
+ done
+
+ step0="$(gh api "repos/${GITHUB_REPOSITORY}/actions/workflows/0-start-exercise.yml" --jq '.state' 2>/dev/null || true)"
+ if [ "$step0" != "active" ]; then
+ gh api --method PUT "repos/${GITHUB_REPOSITORY}/actions/workflows/0-start-exercise.yml/enable"
+ fi
From e3b197ceb88c048672e372e6d1ce1b4d97fe12e2 Mon Sep 17 00:00:00 2001
From: Jocelyn Deleuil <101664783+lilblueyes@users.noreply.github.com>
Date: Fri, 25 Sep 2026 17:00:05 +0200
Subject: [PATCH 2/4] =?UTF-8?q?R=C3=A9initialiser=20depuis=20tutorial-gith?=
=?UTF-8?q?ub-basics=20pour=20test=20final?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/steps/1-create-a-branch.md | 6 +-
.github/steps/2-commit-a-file.md | 4 +-
.github/steps/3-open-a-pull-request.md | 6 +-
.github/steps/4-merge-your-pull-request.md | 4 +-
.github/workflows/reset-fresh-test.yml | 36 ------------
README.md | 66 ++++++++++++++++++++--
6 files changed, 71 insertions(+), 51 deletions(-)
delete mode 100644 .github/workflows/reset-fresh-test.yml
diff --git a/.github/steps/1-create-a-branch.md b/.github/steps/1-create-a-branch.md
index ccac96c..3cfc5c4 100644
--- a/.github/steps/1-create-a-branch.md
+++ b/.github/steps/1-create-a-branch.md
@@ -25,16 +25,16 @@ 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.
diff --git a/.github/steps/2-commit-a-file.md b/.github/steps/2-commit-a-file.md
index baefff0..4e9ccf5 100644
--- a/.github/steps/2-commit-a-file.md
+++ b/.github/steps/2-commit-a-file.md
@@ -29,7 +29,7 @@ Il contient notamment :
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 :
@@ -47,7 +47,7 @@ Il contient notamment :
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...**.
diff --git a/.github/steps/3-open-a-pull-request.md b/.github/steps/3-open-a-pull-request.md
index da5617e..aaf5124 100644
--- a/.github/steps/3-open-a-pull-request.md
+++ b/.github/steps/3-open-a-pull-request.md
@@ -17,7 +17,7 @@ Ouvrir une pull request ne modifie pas encore `main`. Tu demandes simplement :
Après ton commit, GitHub peut afficher **Compare & pull request** :
-
+
Tu peux cliquer dessus. Sinon, utilise directement :
@@ -31,7 +31,7 @@ Si tu passes par l'interface manuelle :
- **base** : `main`
- **compare** : `my-first-branch`
- 
+ 
4. Clique sur **Create pull request**.
@@ -59,7 +59,7 @@ Puis ajoute une courte description, par exemple :
J'ai ajouté PROFILE.md afin de pratiquer mon premier cycle de contribution sur GitHub.
```
-
+
Clique enfin sur **Create pull request**.
diff --git a/.github/steps/4-merge-your-pull-request.md b/.github/steps/4-merge-your-pull-request.md
index 17b0ca6..ca2eba8 100644
--- a/.github/steps/4-merge-your-pull-request.md
+++ b/.github/steps/4-merge-your-pull-request.md
@@ -34,7 +34,7 @@ Un **merge** intègre les changements de ta branche dans la branche de destinati
Après le merge, `PROFILE.md` fera partie de la version principale du dépôt.
-
+
### Activité : merger la pull request
@@ -42,7 +42,7 @@ Après le merge, `PROFILE.md` fera partie de la version principale du dépôt.
2. Clique sur **Confirm merge**.
3. Une fois le merge terminé, clique sur **Delete branch** si GitHub te le propose.
- 
+ 
> [!NOTE]
> Si le bouton de merge est temporairement désactivé, attends la fin des checks puis actualise la page.
diff --git a/.github/workflows/reset-fresh-test.yml b/.github/workflows/reset-fresh-test.yml
deleted file mode 100644
index bd4f12d..0000000
--- a/.github/workflows/reset-fresh-test.yml
+++ /dev/null
@@ -1,36 +0,0 @@
-name: Préparer un test propre GitHub Basics
-
-on:
- push:
- branches:
- - main
- paths:
- - ".github/workflows/reset-fresh-test.yml"
-
-permissions:
- actions: write
- contents: write
-
-jobs:
- reset:
- runs-on: ubuntu-latest
- steps:
- - name: Nettoyer les branches et réactiver Step 0
- env:
- GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- run: |
- set -euo pipefail
-
- gh api --method DELETE "repos/${GITHUB_REPOSITORY}/git/refs/heads/my-first-branch" || true
-
- for workflow in 1-create-a-branch.yml 2-commit-a-file.yml 3-open-a-pull-request.yml 4-merge-your-pull-request.yml; do
- state="$(gh api "repos/${GITHUB_REPOSITORY}/actions/workflows/$workflow" --jq '.state' 2>/dev/null || true)"
- if [ "$state" = "active" ]; then
- gh api --method PUT "repos/${GITHUB_REPOSITORY}/actions/workflows/$workflow/disable"
- fi
- done
-
- step0="$(gh api "repos/${GITHUB_REPOSITORY}/actions/workflows/0-start-exercise.yml" --jq '.state' 2>/dev/null || true)"
- if [ "$step0" != "active" ]; then
- gh api --method PUT "repos/${GITHUB_REPOSITORY}/actions/workflows/0-start-exercise.yml/enable"
- fi
diff --git a/README.md b/README.md
index 37e1225..349e35d 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,68 @@
+
+
# GitHub Basics
-
+
+
+_Découvre GitHub en moins d'une heure, directement depuis l'interface web._
+
+
+
+## Bienvenue
+
+GitHub est une plateforme de collaboration pour les projets versionnés avec **Git**.
+
+- **Git** enregistre l'historique des fichiers d'un projet.
+- Un **dépôt** (ou _repository_) est le dossier de projet suivi par Git et hébergé sur GitHub.
+- Une **Issue** est un fil de suivi utilisé pour discuter d'une tâche, d'un problème ou d'un objectif.
+- Une **branche** est une version parallèle du projet sur laquelle tu peux travailler sans modifier immédiatement la version principale.
+- Un **commit** est un enregistrement identifié d'un ensemble de modifications.
+- Une **pull request** est une proposition pour intégrer les changements d'une branche dans une autre après les avoir relus.
+- Un **merge** est l'intégration effective de ces changements.
+
+Tu n'as pas besoin de mémoriser ces définitions maintenant. Le cours va reprendre chaque notion dans l'ordre, au moment où tu l'utiliseras.
+
+## Ce que tu vas faire
+
+Pendant l'exercice, tu vas :
+
+1. créer une branche appelée `my-first-branch` ;
+2. créer un fichier Markdown nommé `PROFILE.md` ;
+3. prévisualiser son rendu puis enregistrer le changement dans un commit ;
+4. ouvrir une pull request vers `main` ;
+5. relire les changements et merger la pull request.
+
+Le bot te guidera d'abord dans une Issue dédiée. Lorsque tu ouvriras ta pull request, la suite du cours apparaîtra directement dans sa conversation pour éviter de jongler entre plusieurs onglets.
+
+> [!NOTE]
+> Ce premier cours utilise volontairement l'interface web de GitHub. Le travail quotidien du club se fera ensuite surtout avec **Git en ligne de commande et VS Code**. Le tutoriel suivant est déjà disponible : [Git & VS Code](https://github.com/ENSTARobotics/tutorial-git-vscode).
+
+## Pour qui ?
+
+Ce cours s'adresse aux personnes qui découvrent GitHub, notamment aux étudiants et aux nouveaux contributeurs à un projet logiciel ou robotique.
+
+- **Durée :** environ 30 à 60 minutes.
+- **Prérequis :** aucun, à part un compte GitHub.
+
+## Commencer le cours
+
+Crée un nouveau dépôt à partir de ce **dépôt modèle** (_template_). Un dépôt modèle est un dépôt prévu pour servir de point de départ : GitHub en copie les fichiers et les automatisations dans ton nouveau dépôt. N'utilise pas **Fork** : un fork est une copie liée au dépôt d'origine, surtout utile pour proposer des contributions à un projet existant. Ici, on veut au contraire une copie indépendante créée depuis le modèle.
+
+[](https://github.com/new?template_owner=ENSTARobotics&template_name=tutorial-github-basics&owner=%40me&name=tutorial-github-basics&description=Tutoriel%20interactif%20%3A%20d%C3%A9couvrir%20les%20bases%20de%20GitHub&visibility=public)
+
+Après la création du dépôt :
+
+1. attends une vingtaine de secondes ;
+2. actualise la page ;
+3. ouvre l'Issue créée automatiquement par Mona.
-Salut lilblueyes !
+
+Le cours ne démarre pas ?
-Ton exercice est prêt.
+Ouvre l'onglet **Actions** du dépôt. **GitHub Actions** est le système d'automatisation de GitHub utilisé par le bot du cours. Vérifie le **workflow** **Step 0**. Un workflow est une automatisation décrite pour GitHub Actions. Si son exécution a échoué, son journal indique généralement la cause.
-L'Issue ci-dessous est le point de départ et le journal de progression. Ensuite, le cours se déplacera avec toi : lorsque tu arriveras dans une pull request, le bot continuera directement dans sa conversation.
+
-[](https://github.com/FIPATECH/github-basics2/issues/7)
+---
+Inspiré de [GitHub Skills - Introduction to GitHub](https://github.com/skills/introduction-to-github).
From a5895fbbaab874f409f21b15f8feac56612a883f Mon Sep 17 00:00:00 2001
From: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 25 Sep 2026 15:00:17 +0000
Subject: [PATCH 3/4] =?UTF-8?q?D=C3=A9marrer=20l'exercice?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/steps/1-create-a-branch.md | 6 +-
.github/steps/2-commit-a-file.md | 4 +-
.github/steps/3-open-a-pull-request.md | 6 +-
.github/steps/4-merge-your-pull-request.md | 4 +-
README.md | 66 ++--------------------
5 files changed, 15 insertions(+), 71 deletions(-)
diff --git a/.github/steps/1-create-a-branch.md b/.github/steps/1-create-a-branch.md
index 3cfc5c4..ccac96c 100644
--- a/.github/steps/1-create-a-branch.md
+++ b/.github/steps/1-create-a-branch.md
@@ -25,16 +25,16 @@ 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.
diff --git a/.github/steps/2-commit-a-file.md b/.github/steps/2-commit-a-file.md
index 4e9ccf5..baefff0 100644
--- a/.github/steps/2-commit-a-file.md
+++ b/.github/steps/2-commit-a-file.md
@@ -29,7 +29,7 @@ Il contient notamment :
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 :
@@ -47,7 +47,7 @@ Il contient notamment :
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...**.
diff --git a/.github/steps/3-open-a-pull-request.md b/.github/steps/3-open-a-pull-request.md
index aaf5124..da5617e 100644
--- a/.github/steps/3-open-a-pull-request.md
+++ b/.github/steps/3-open-a-pull-request.md
@@ -17,7 +17,7 @@ Ouvrir une pull request ne modifie pas encore `main`. Tu demandes simplement :
Après ton commit, GitHub peut afficher **Compare & pull request** :
-
+
Tu peux cliquer dessus. Sinon, utilise directement :
@@ -31,7 +31,7 @@ Si tu passes par l'interface manuelle :
- **base** : `main`
- **compare** : `my-first-branch`
- 
+ 
4. Clique sur **Create pull request**.
@@ -59,7 +59,7 @@ Puis ajoute une courte description, par exemple :
J'ai ajouté PROFILE.md afin de pratiquer mon premier cycle de contribution sur GitHub.
```
-
+
Clique enfin sur **Create pull request**.
diff --git a/.github/steps/4-merge-your-pull-request.md b/.github/steps/4-merge-your-pull-request.md
index ca2eba8..17b0ca6 100644
--- a/.github/steps/4-merge-your-pull-request.md
+++ b/.github/steps/4-merge-your-pull-request.md
@@ -34,7 +34,7 @@ Un **merge** intègre les changements de ta branche dans la branche de destinati
Après le merge, `PROFILE.md` fera partie de la version principale du dépôt.
-
+
### Activité : merger la pull request
@@ -42,7 +42,7 @@ Après le merge, `PROFILE.md` fera partie de la version principale du dépôt.
2. Clique sur **Confirm merge**.
3. Une fois le merge terminé, clique sur **Delete branch** si GitHub te le propose.
- 
+ 
> [!NOTE]
> Si le bouton de merge est temporairement désactivé, attends la fin des checks puis actualise la page.
diff --git a/README.md b/README.md
index 349e35d..8338ae9 100644
--- a/README.md
+++ b/README.md
@@ -1,68 +1,12 @@
-
-
# GitHub Basics
-
-
-_Découvre GitHub en moins d'une heure, directement depuis l'interface web._
-
-
-
-## Bienvenue
-
-GitHub est une plateforme de collaboration pour les projets versionnés avec **Git**.
-
-- **Git** enregistre l'historique des fichiers d'un projet.
-- Un **dépôt** (ou _repository_) est le dossier de projet suivi par Git et hébergé sur GitHub.
-- Une **Issue** est un fil de suivi utilisé pour discuter d'une tâche, d'un problème ou d'un objectif.
-- Une **branche** est une version parallèle du projet sur laquelle tu peux travailler sans modifier immédiatement la version principale.
-- Un **commit** est un enregistrement identifié d'un ensemble de modifications.
-- Une **pull request** est une proposition pour intégrer les changements d'une branche dans une autre après les avoir relus.
-- Un **merge** est l'intégration effective de ces changements.
-
-Tu n'as pas besoin de mémoriser ces définitions maintenant. Le cours va reprendre chaque notion dans l'ordre, au moment où tu l'utiliseras.
-
-## Ce que tu vas faire
-
-Pendant l'exercice, tu vas :
-
-1. créer une branche appelée `my-first-branch` ;
-2. créer un fichier Markdown nommé `PROFILE.md` ;
-3. prévisualiser son rendu puis enregistrer le changement dans un commit ;
-4. ouvrir une pull request vers `main` ;
-5. relire les changements et merger la pull request.
-
-Le bot te guidera d'abord dans une Issue dédiée. Lorsque tu ouvriras ta pull request, la suite du cours apparaîtra directement dans sa conversation pour éviter de jongler entre plusieurs onglets.
-
-> [!NOTE]
-> Ce premier cours utilise volontairement l'interface web de GitHub. Le travail quotidien du club se fera ensuite surtout avec **Git en ligne de commande et VS Code**. Le tutoriel suivant est déjà disponible : [Git & VS Code](https://github.com/ENSTARobotics/tutorial-git-vscode).
-
-## Pour qui ?
-
-Ce cours s'adresse aux personnes qui découvrent GitHub, notamment aux étudiants et aux nouveaux contributeurs à un projet logiciel ou robotique.
-
-- **Durée :** environ 30 à 60 minutes.
-- **Prérequis :** aucun, à part un compte GitHub.
-
-## Commencer le cours
-
-Crée un nouveau dépôt à partir de ce **dépôt modèle** (_template_). Un dépôt modèle est un dépôt prévu pour servir de point de départ : GitHub en copie les fichiers et les automatisations dans ton nouveau dépôt. N'utilise pas **Fork** : un fork est une copie liée au dépôt d'origine, surtout utile pour proposer des contributions à un projet existant. Ici, on veut au contraire une copie indépendante créée depuis le modèle.
-
-[](https://github.com/new?template_owner=ENSTARobotics&template_name=tutorial-github-basics&owner=%40me&name=tutorial-github-basics&description=Tutoriel%20interactif%20%3A%20d%C3%A9couvrir%20les%20bases%20de%20GitHub&visibility=public)
-
-Après la création du dépôt :
-
-1. attends une vingtaine de secondes ;
-2. actualise la page ;
-3. ouvre l'Issue créée automatiquement par Mona.
+
-
-Le cours ne démarre pas ?
+Salut lilblueyes !
-Ouvre l'onglet **Actions** du dépôt. **GitHub Actions** est le système d'automatisation de GitHub utilisé par le bot du cours. Vérifie le **workflow** **Step 0**. Un workflow est une automatisation décrite pour GitHub Actions. Si son exécution a échoué, son journal indique généralement la cause.
+Ton exercice est prêt.
-
+L'Issue ci-dessous est le point de départ et le journal de progression. Ensuite, le cours se déplacera avec toi : lorsque tu arriveras dans une pull request, le bot continuera directement dans sa conversation.
----
+[](https://github.com/FIPATECH/github-basics2/issues/9)
-Inspiré de [GitHub Skills - Introduction to GitHub](https://github.com/skills/introduction-to-github).
From 666db13981874aea19194d58c4340eb264950f6a Mon Sep 17 00:00:00 2001
From: Jocelyn Deleuil <101664783+lilblueyes@users.noreply.github.com>
Date: Fri, 25 Sep 2026 17:01:09 +0200
Subject: [PATCH 4/4] =?UTF-8?q?Cr=C3=A9er=20mon=20profil=20de=20test?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
PROFILE.md | 5 +++++
1 file changed, 5 insertions(+)
create mode 100644 PROFILE.md
diff --git a/PROFILE.md b/PROFILE.md
new file mode 100644
index 0000000..de8dd34
--- /dev/null
+++ b/PROFILE.md
@@ -0,0 +1,5 @@
+# Mon profil
+
+Hello GitHub !
+
+Je teste le tutoriel en allant volontairement plus vite que le bot.