Your first contribution

[github-learning-lab]

Introduction au flux GitHub

Maintenant que vous connaissez les Issues, utilisons ce problème pour suivre votre cheminement vers votre première contribution.

Les gens utilisent différents workflows pour contribuer à des projets logiciels, mais le moyen le plus simple et le plus efficace de contribuer sur GitHub est le workflow GitHub.

📺 Video: Comprendre le flux GitHub

---

Lisez les étapes suivantes ci-dessous

[github-learning-lab]

Étape 4: Création d'une branche

Réalisons la première étape d'une démarche typique sur GitHub : la création d'une branche ^📖.

Création d'une branche

Création d'une branche

📺 Video: Branches

Vous venez d'apprendre à créer une branche, la première étape du travail sur GitHub.

Les branches sont des éléments importants de la démarche sur GitHub car elles nous permettent d'isoler le travail en cours de la branche principale main. En d'autres termes, le travail des autres est protégé pendant que vous mettez au point votre contribution.

Conseils pour l'utilisation de branches

Un projet seul peut avoir des centaines de branches, chacune comportant une nouvelle modification de la branche main.

La meilleure façon de gérer ces branches quand on travaille en équipe est de veiller à les maintenir concises et éphémères. Autrement dit, une branche doit comporter une seule nouvelle fonctionalité ou correction de bug. Les incompréhensions entre contributeurs sont réduites lorsque les branches ne sont actives que quelques jours avant d'être fusionnées ^📖 avec la branche main.

---

⌨️ Activité : Votre première branche

1. Téléchargez et installez Visual Studio Code (aussi appelé VS Code) si vous ne l'avez pas déjà.
2. Dans VS Code, ouvrez la pallette de commandes (Command Palette) avec Ctrl+Shift+P sous Windows, ou Command ⌘+Shift+P sous macOS. Vous pourvez égalememnt consulter la documentation officielle de VS Code sur la création de clones.
3. Tapez: git clone et pressez Enter
   
4. Collez l'adresse du dépôt dans la nouvelle fenêtre et pressez Enter:

   https://github.com/CharlesBT/github-slideshow.git

5. Sélectionnez l'emplacement où sauvegarder le dépôt et cliquez Choose folder. Ouvrez ensuite l'emplacement que vous avez sélectionné.
6. Le répertoire du dépôt doit maintenant être ouvert dans votre espace de travail VS Code. Cliquez sur main en bas et à gauche de la fenêtre VS Code. Ceci ouvrira la palette avec les commandes relatives aux branches Git.
   
7. Cliquez sur Create new branch et saisissez le nom que vous désirez, par exemple my-slide. Pressez ensuite Enter.
8. Lorsqu'il vous est demandé de sélectioner la référence à partir de laquelle créer la branche, sélectioner main.
9. Allez dans la vue "Source Control", cliquez sur les points de suspension (...) et séléctionnez Push. Confirmez lorsque le boite de dialogue vous propose de publier la branche.
   

---

Je vous répondrai ici lorsque j'aurai détecté qu'une nouvelle branche a été crée dans ce dépôt.

[github-learning-lab]

Étape 5: Soumettre un fichier

🎉 Vous avez créé une branche!

Créer une branche vous permet d'apporter des modifications à votre projet sans changer main, la branche déployée. Maintenant que vous avez une branche, il est temps de créer un fichier et d'effectuer votre première contribution!

Bases de la contribution

Bases de la contribution

Lorsque vous avez fini la création ou l'édition d'un fichier sur GitHub, faites défiler la page jusqu'en bas et répérez la section "Commit new file".

Saisissez un intitulé à la contribution. Ce message doit informer rapidement les contributeurs sur l'objet du changement introduit dans le fichier.

Règles de bienséance pour l'écriture d'un intitulé de contribution:

• Ne pas terminer votre message par un point.
• Restreignez votre message à 50 caractères ou moins. Ajoutez si nécessaire les détails complémentaires dans la fenêtre de description étendue. Elle se situe juste sous la ligne d'intitulé.
• Utilisez la forme active. Par exemple, "Ajout" au lieu de "Ajouté" and "correction" au lieu de "corrigé".
• Considérez votre intitulé de contribution comme l'expression de votre intention lors de l'introduction du changement.

---

⌨️ Activité: Votre première contribution

Les prochaines étapes vous guideront à travers le processus de soumission d'un changement sur GitHub.

1. Dans le dossier _posts, créez un nouveau fichier nommé 0000-01-02-CharlesBT.md. Le nom complet de votre fichier doit être: _posts/0000-01-02-CharlesBT.md.
2. Ajoutez le contenu suivant à votre fichier et enregistrez-le :

   ---
   layout: slide
   title: "Welcome to our second slide!"
   ---
   Your text
   Use the left arrow to go back!

3. Pour ajouter votre fichier à l'espace de travail : allez dans la vue Source Control et cliquez le bouton + à côté du fichier. Vous pouvez également vous référer à la documentation officielle de VS Code.
   
4. Soumetez le changement en saisissant un intitulé dans le champ de texte puis en pressant Ctrl+Enter sur Windows ou Command ⌘+Enter sur macOS.
   
5. Cliquez sur les points de suspension (...) et sélectionnez Push.

---

Je vous répondrai lorsque j'aurai détecté une nouvelle contibution sur cette branche.