Giter VIP home page Giter VIP logo

Comments (3)

github-learning-lab avatar github-learning-lab commented on July 19, 2024

É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 master. 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 master.

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


⌨️ Activité : Votre première branche

  1. Naviguez vers l'onglet Code
  2. Cliquez Branch: master dans la liste déroulante
  3. Dans le champs de texte, saisissez un nom de branche, tel que my-slide
  4. Cliquez Create branch: ou pressez la touche Enter pour créer votre branche

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

from github-slideshow.

github-learning-lab avatar github-learning-lab commented on July 19, 2024

Étape 5: Soumettre un fichier

🎉 Vous avez créé une branche!

Créer une branche vous permet d'apporter des modifications à votre projet sans changer master, 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. Sur cette branche, créez un dossier _posts et ajoutez y un nouveau fichier nommé 0000-01-02-BadSpencer.md. Vous pouvez le faire en utilisant ce raccourci ou manuellement comme suit:
    • Retournez à l'onglet "Code"
    • Dans la liste déroulante des branches, sélectionnez "dev"
    • Cliquez Create new file
    • Dans le champ "file name", saisissez _posts/0000-01-02-BadSpencer.md. La saisie de / dans le nom de fichier placera automatiquement votre fichier dans le répertoire _posts.
  2. Lorsque vous aurez nommé le fichier, ajoutez-y le contenu suivant:
    ---
    layout: slide
    title: "Welcome to our second slide!"
    ---
    Your text
    Use the left arrow to go back!
  3. Après avoir ajouté le texte, vous pouvez soumettre le changement en fournissant un intitulé dans le champ de texte sous la fenêtre d'édition du fichier. Des recommendations relatives aux intitulés de soumission sont disponibles via le lien déroulant Bases de la contribution, juste au-dessus de ces instructions
  4. Une fois saisis votre intitulé de contribution, cliquez Commit new file

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

from github-slideshow.

github-learning-lab avatar github-learning-lab commented on July 19, 2024

Étape 6: Ouvrez une Pull Request

Bravo pour cette contribution ✨

Maintenant que vous avez créé une contribution, il est temps de partager la modification que vous proposez via une Pull Request ! Là où les Issues encouragent l'échange avec d'autres contributeurs et collaborateurs sur un projet, les Pull Request vous aident à partager vos modifications, à recevoir des commentaires à leur sujet et à itérer jusqu'à ce qu'elles soient parfaites !

Qu'est-ce qu'une Pull Request ?

Pull requests

Revenons au workflow de GitHub. Vous avez créé une branche, ajouté un fichier et validé le fichier dans votre branche. Il est maintenant temps de collaborer sur votre dossier avec d'autres étudiants qui suivent ce cours. Cette collaboration se produit dans une Pull Request. Visionnez cette vidéo pour en savoir plus :

📺 Video: Introduction aux Pull Requests


Cette Pull Request va conserver les modifications que vous venez de faire sur votre branche tout en proposant de les appliquer également à la branche master.

⌨️ Activité: Créer une Pull Request

  1. Ouvrez une Pull Request grâce à ce raccourci ou manuellement comme suit :
    • Depuis l'onglet "Pull requests", cliquez New pull request
    • Dans le menu déroulant "base:", assurez vous que la branche master est sélectionnée
    • Dans le menu déroulant "compare:", sélectionnez "dev"
  2. Lorsque vous avez sélectionné votre branche, saisissez un titre pour votre Pull Request. Par exemple Ajout du fichier de BadSpencer
  3. Le champ suivant vous aide à fournir une description des modifications que vous avez apportées. N'hésitez pas à ajouter une description de ce que vous avez accompli jusqu'à présent. Pour rappel, vous avez: créé une branche, créé un fichier et effectué une contribution, et ouvert une Pull Request
  4. Cliquez Create pull request

Je vous répondrai dans votre nouvelle Pull Request.

from github-slideshow.

Related Issues (2)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.