|
2 | 2 |
|
3 | 3 | # Introduction à GitHub |
4 | 4 |
|
5 | | -_Démarre sur GitHub en moins d’une heure._ |
| 5 | +<img src="https://octodex.github.com/images/original.png" align="right" height="160px" /> |
| 6 | + |
| 7 | +_Découvre GitHub en moins d’une heure._ |
6 | 8 |
|
7 | 9 | </header> |
8 | 10 |
|
9 | 11 | ## Bienvenue |
10 | 12 |
|
11 | | -Des jeux vidéo aux expériences data, GitHub propulse certains des projets les plus avancés. Que tu débutes ou que tu aies juste besoin d’un rappel, ce mini cours “Introduction à GitHub” te guide pas à pas pour contribuer rapidement. |
| 13 | +Bienvenue dans **GitHub Basics**, un cours interactif pour découvrir le workflow utilisé dans de nombreux projets logiciels. |
| 14 | + |
| 15 | +Tu vas apprendre en pratiquant directement dans un dépôt GitHub : pas besoin d’avoir déjà utilisé Git. |
| 16 | + |
| 17 | +## 🎯 Objectifs |
| 18 | + |
| 19 | +À la fin de ce cours, tu sauras : |
| 20 | + |
| 21 | +- comprendre la différence entre Git et GitHub ; |
| 22 | +- créer et utiliser une branche ; |
| 23 | +- créer un commit propre ; |
| 24 | +- ouvrir une Pull Request ; |
| 25 | +- relire et merger une contribution. |
| 26 | + |
| 27 | +## 👥 Pour qui ? |
12 | 28 |
|
13 | | -- **Pour qui**: nouveaux développeurs, nouveaux utilisateurs GitHub, étudiants. |
14 | | -- **Ce que tu vas apprendre**: dépôts, branches, commits, pull requests. |
15 | | -- **Ce que tu vas construire**: une petite modification de documentation proposée via une pull request. |
16 | | -- **Prérequis**: aucun, un compte GitHub suffit. |
17 | | -- **Durée**: moins d’une heure. |
| 29 | +Ce cours s’adresse notamment aux : |
18 | 30 |
|
19 | | -Dans ce cours, tu vas: |
| 31 | +- nouveaux développeurs ; |
| 32 | +- étudiants en informatique ; |
| 33 | +- étudiants en robotique, systèmes embarqués, drones ou IA ; |
| 34 | +- personnes découvrant le travail collaboratif logiciel. |
20 | 35 |
|
21 | | -1. Créer une branche |
22 | | -2. Commiter un fichier |
23 | | -3. Ouvrir une pull request |
24 | | -4. Merger ta pull request |
| 36 | +## ⏱️ Durée et prérequis |
25 | 37 |
|
26 | | -### Comment démarrer le cours |
| 38 | +- **Durée estimée :** environ 30 à 60 minutes. |
| 39 | +- **Prérequis :** aucun. Un compte GitHub suffit. |
27 | 40 |
|
28 | | -> Important, **clique sur le bouton ci-dessous** pour créer un **nouveau dépôt depuis la template**. N’utilise pas “Fork”, sinon les Actions risquent de ne pas se lancer automatiquement. Les dépôts privés consomment des minutes GitHub Actions. |
| 41 | +## 🚀 Ce que tu vas réaliser |
| 42 | + |
| 43 | +Tu vas suivre un workflow complet : |
| 44 | + |
| 45 | +1. Créer une branche. |
| 46 | +2. Modifier un fichier. |
| 47 | +3. Créer un commit. |
| 48 | +4. Ouvrir une Pull Request. |
| 49 | +5. Merger ta contribution. |
| 50 | + |
| 51 | +## Comment démarrer le cours |
| 52 | + |
| 53 | +> Important : clique sur le bouton ci-dessous pour créer un **nouveau dépôt depuis la template**. N'utilise pas Fork, sinon les Actions du cours peuvent ne pas se lancer correctement. |
29 | 54 |
|
30 | 55 | [](https://github.com/new?template_owner=ENSTASIMOV&template_name=github-basics&owner=%40me&name=github-basics&description=Exercice%3A%20GitHub%20Basics&visibility=public) |
31 | 56 |
|
32 | | -1. Clic droit sur **Commencer le cours** puis “Ouvrir le lien dans un nouvel onglet”. |
33 | | -2. Dans le nouvel onglet, la plupart des champs sont préremplis, choisis le propriétaire du dépôt. |
34 | | -3. Clique sur **Create repository** en bas du formulaire. |
35 | | -4. Attends environ **20 secondes**, puis **rafraîchis** la page, les instructions étape par étape apparaîtront dans les Issues. |
| 57 | +1. Ouvre le lien dans un nouvel onglet. |
| 58 | +2. Choisis le propriétaire du nouveau dépôt. |
| 59 | +3. Clique sur **Create repository**. |
| 60 | +4. Attends quelques secondes puis ouvre l'Issue créée automatiquement. |
| 61 | + |
| 62 | +Le cours se déroulera directement dans cette Issue avec des étapes guidées. |
36 | 63 |
|
37 | 64 | --- |
38 | 65 |
|
39 | 66 | ## Support |
40 | 67 |
|
41 | | -Besoin d’aide, ouvre une issue dans ce dépôt. |
42 | | -Statut de GitHub, [status.github.com](https://www.githubstatus.com/) |
| 68 | +Besoin d'aide ? Ouvre une issue dans ce dépôt. |
43 | 69 |
|
44 | | -© 2025 GitHub • [Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/code_of_conduct.md) • [MIT License](https://gh.io/mit) |
|
0 commit comments