Inspiré par First Contributions de Roshan Jossey
GitHub est considéré comme un outil essentiel pour les ingénieurs logiciels, et sa
popularité est inégalée. Il accueille actuellement plus de 25 millions d’utilisateurs.
C’est un nombre considérable de professionnels qui se tournent vers GitHub pour
améliorer le flux de travail et la collaboration.
En bref, GitHub est un service basé sur le cloud qui héberge un système de
contrôle de version (VCS) appelé Git. Il permet aux développeurs de collaborer et
d’apporter des modifications à des projets partagés tout en gardant un suivi détaillé
de leur progression.
Pour mieux comprendre ce qu’est GitHub et comment il fonctionne, nous devons en
regarder alors plus en profondeur.
Le contrôle de version est un système qui permet de suivre et de gérer les modifications apportées à un fichier ou à un ensemble de fichiers. Principalement utilisé par les ingénieurs logiciels pour suivre les modifications apportées au code source, le système de contrôle de version leur permet d’analyser toutes les modifications et de les annuler sans répercussion en cas d’erreur. En d’autres termes, le contrôle de version permet aux développeurs de travailler simultanément sur des projets. Il leur permet d’apporter autant de modifications qu’ils le souhaitent sans empiéter sur le travail de leurs collègues ni le retarder. Si les dites modifications du code source ruinent le projet au moment de leur déploiement, GitHub permet de les annuler facilement en quelques clics, et la version précédente du projet sera ramenée. En résumé, le contrôle de version élimine les risques et l’aléa de faire trop d’erreurs. Au contraire, il offre la liberté de collaborer et de développer sans trop d’inquiétude.
Git est un projet open-source qui a été lancé en 2005 et qui est devenu l’un des VCS les plus populaires du marché – plus de 87% des développeurs utilisent Git pour leurs projets. Il s’agit d’un système de contrôle de version distribué. Cela signifie que tout développeur de l’équipe ayant un accès autorisé peut gérer le code source et l’historique des modifications à l’aide des outils de ligne de commande Git. Contrairement aux systèmes de contrôle de version centralisés, Git offre des branches de fonctionnalités. Cela signifie que chaque ingénieur logiciel de l’équipe peut créer une branche de fonctionnalité qui fournit un dépôt local isolé pour apporter des modifications au code. Les branches de fonctionnalités n’affectent pas la branche principale, où se trouve le code original du projet. Une fois les modifications effectuées et le code mis à jour prêt, la branche des fonctionnalités peut être fusionnée avec la branche principale, et c’est ainsi que les modifications apportées au projet deviennent effectives.
C'est toujours compliqué la première fois que l'on fait quelque chose. La peur de faire des fautes n'est pas du tout confortable, spécialement quand vous collaborez. Mais le monde du logiciel libre est fait de collaboration et de travail de groupe. Aussi, nous voulons simplifier l'apprentissage des nouveaux contributeurs au logiciel libre en vous enseignant à contribuer pour la première fois.
Lire des articles et des tutoriels peut aider, mais qu'y a-t-il de mieux que d'essayer sans pouvoir faire d'erreurs ? Ce projet a pour ambition de fournir des conseils et simplifier la manière dont les apprentis font leur première contribution. Souvenez-vous : plus vous êtes serein, mieux vous apprenez. Si vous aspirez à faire votre première contribution, suivez tout simplement les étapes suivantes. Promis, ce sera amusant.
Si vous n'avez pas git sur votre ordinateur, installez-le .
Embranchez ce répertoire en cliquant sur le bouton de fork en haut de la page. Cela va créer une copie du répertoire sur votre compte.
Maintenant, clonez ce répertoire sur votre ordinateur. Cliquez sur le bouton clone puis cliquez sur l'icone copier dans le presse-papier.
Ouvrez un invite de commande et exécutez les commandes git suivantes :
git clone "l'url que vous venez de copier"
où "l'url que vous venez de copier" (sans les guillemets) est l'url du répertoire. Voir la section précédente afin d'obtenir l'url.
Par exemple :
git clone https://github.com/votre-nom-d-utilisateur/galsendev-first-contributions.git
où votre-nom-d-utilisateur est votre nom d'utilisateur GitHub. Ici vous êtes en train de copier le contenu du répertoire first-contributions depuis GitHub sur votre ordinateur.
Déplacez-vous dans le répertoire du projet nouvellement cloné (si vous n'y êtes pas encore) :
cd galsendev-first-contributions
Maintenant créez une branche avec le commande git checkout :
git checkout -b <add-votre-nom>
Par exemple :
git checkout -b add-Galsen-Dev-LAB
(Le nom de la branche n'a pas besoin de contenir le terme add, mais c'est raisonnable de l'inclure parce que l'objectif de cette branche est d'ajouter votre nom Ă une liste.)
Maintenant, ouvrez le fichier Contributors.md dans un éditeur de texte, ajoutez-y votre nom, et enregistrez-le. Si vous ouvrez l'invite de commande et vous exécutez la commande git status, vous verrez qu'il y a des modifications. Ajoutez ces modifications à la branche que vous venez de créer avec la commande git add :
git add Contributors.md
Maintenant engagez ces modifications avec la commande git commit:
git commit -m "Add <votre-nom> to Contributors list"
en remplaçant <votre-nom> par votre nom.
Envoyer vos modifications avec la commande git push :
git push origin <add-votre-nom>
en remplaçant <add-votre-nom> avec le nom de la branche précédemment créée.
Si vous visitez votre répertoire sur Github, vous verrez un bouton Compare & pull request. Cliquez sur ce bouton.
Maintenant soumettez la demande.
Sous peu j'aurai fusionné toutes vos modifications avec la branche master de ce projet. Vous recevrez un mail de notification dès que la fusion sera effectuée.
La branche master de votre embranchement ne subira pas de modification à cet instant. Pour que votre embranchement soit synchronisé avec le mien, suivez les étapes suivantes.
D'abord, basculez sur la branche master
git checkout master
Et ajouter l'url de mon répertoire comme upstream remote url :
git remote add upstream https://github.com/Galsen-Dev-LAB/galsendev-first-contributions
Ceci est une manière de dire à git qu'une autre version de ce répertoire existe à l'adresse spécifiée et que nous l'appelons upstream. Une fois les modifications fusionnées, cherchez la nouvelle version de mon répertoire :
git fetch upstream
Ici nous cherchons toutes les modification dans mon embranchement (upstream remote). Maintenant, vous devez fusionner la nouvelle révision de mon répertoire avec votre branche master :
git rebase upstream/master
Ici nous appliquons toutes les modifications que vous avez cherché à la branche master. Si vous poussez la branche master maintenant, votre embranchement aussi aura les modifications :
git push origin master
Avertissement: Cette fois, vous poussez au répertoire distant appelé origin.
A ce niveau j'ai fusionné votre branche <add-votre-nom> avec ma branche master, et vous avez fusionné ma branche master avec votre branche master. Votre branche <add-votre-nom> n'est plus utile, donc vous pouvez la supprimer :
git branch -d <add-votre-nom>
et vous pouvez supprimer sa version dans le répertoire distant aussi :
git push origin --delete <add-votre-nom>
Ceci n'est pas nécessaire, mais le nom de la branche montre que son objectif est assez spécifique. Sa durée de vie peut être courte.
Bien que GitHub soit principalement connu au sein de la communauté des ingénieurs logiciels, il peut être utilisé dans une variété de secteurs différents. Toute équipe ou entreprise qui travaille sur différents projets nécessitant un développement sous forme de fichiers peut utiliser ce service. Par exemple, les équipes de contenu et de marketing peuvent utiliser GitHub pour organiser leurs projets. Les créatifs indépendants peuvent l’utiliser pour gérer leur travail lorsqu’ils collaborent avec d’autres personnes. Utiliser GitHub ne signifie pas nécessairement utiliser du code ou être un développeur. Il s’agit d’une plateforme gratuite de système de contrôle de version qui peut être utilisée de nombreuses manières différentes