Étape 1 : Créer un compte Github
Pour commencer, il faut créer un compte Github. Vous pouvez le faire en allant sur le site web de Github et en suivant les instructions pour créer un compte.
Étape 2 : Créer un nouveau repository
Une fois que vous avez créé votre compte, vous pouvez créer un nouveau repository. Pour cela, cliquez sur le bouton « New » dans votre tableau de bord Github, puis suivez les instructions pour créer un nouveau repository. Vous pouvez également importer un repository existant à partir d’un autre service de gestion de code source, comme GitLab ou Bitbucket.
Étape 3 : Cloner le repository en local
Maintenant que vous avez créé un repository, vous devez le cloner en local pour pouvoir travailler sur le code. Pour cela, vous devez utiliser Git, le logiciel de gestion de code source utilisé par Github. Ouvrez votre terminal et entrez la commande suivante :
git clone <url-du-repository>
Remplacez <url-du-repository> par l’URL de votre repository Github.
Étape 4 : Créer une nouvelle branche
Il est recommandé de travailler sur une branche distincte pour chaque fonctionnalité ou correction de bug. Cela facilite la gestion des modifications et évite les conflits. Pour créer une nouvelle branche, utilisez la commande suivante :
git checkout -b nom-de-la-branche
Remplacez nom-de-la-branche par le nom de votre nouvelle branche.
Étape 5 : Faire des modifications et créer des commits
Maintenant que vous travaillez sur une nouvelle branche, vous pouvez faire des modifications au code. Une fois que vous avez terminé, vous devez créer un commit pour enregistrer vos modifications. Utilisez la commande suivante :
git add .
git commit -m "message-de-commit"
La première commande ajoute toutes les modifications que vous avez apportées. La seconde crée un nouveau commit avec un message de commit explicatif.
Étape 6 : Pousser les modifications sur Github
Une fois que vous avez créé un ou plusieurs commits, vous pouvez pousser vos modifications sur Github en utilisant la commande suivante :
git push origin nom-de-la-branche
Remplacez nom-de-la-branche par le nom de votre branche. Cela va pousser vos modifications sur Github et créer une nouvelle branche sur le repository.
Étape 7 : Créer une pull request
Maintenant que vous avez poussé vos modifications sur Github, vous pouvez créer une pull request pour demander la fusion de votre branche avec la branche principale. Pour cela, allez sur la page de votre repository Github, cliquez sur l’onglet « Pull requests », puis cliquez sur le bouton « New pull request ». Choisissez votre branche et la branche principale, puis remplissez les informations de la pull request et cliquez sur le bouton « Create pull request ».
Étape 8 : Réviser et fusionner la pull request
Une fois que vous avez créé la pull request, les autres contributeurs peuvent la réviser et apporter des commentaires. Vous pouvez discuter et apporter des modifications en utilisant les commentaires de la pull request. Une fois que tout le monde est satisfait, vous pouvez fusionner la pull request en utilisant le bouton « Merge pull request » sur Github.
Avant de fusionner la pull request, assurez-vous que le code est cohérent avec le reste du projet et qu’il respecte les normes de qualité et de collaboration en vigueur. Une fois que vous avez fusionné la pull request, la nouvelle fonctionnalité ou la correction de bug sera disponible dans la branche principale. Vous pouvez ensuite supprimer la branche de la pull request en utilisant le bouton « Delete branch » sur Github.
Il est important de noter que la fusion de la pull request peut entraîner des conflits, notamment si d’autres contributeurs ont modifié la même partie du code. Dans ce cas, vous devrez résoudre les conflits en discutant avec les autres contributeurs et en apportant des modifications supplémentaires.
Étape 9 : Mettre à jour votre repository local
Après avoir fusionné votre pull request, vous devez mettre à jour votre repository local pour inclure les dernières modifications. Pour cela, utilisez la commande suivante :
git checkout main
git pull origin main
La première commande vous déplace sur la branche principale, et la seconde récupère les dernières modifications de la branche principale sur Github.
Étape 10 : Répéter le processus pour chaque fonctionnalité
Répétez le processus pour chaque nouvelle fonctionnalité ou correction de bug que vous souhaitez apporter à votre projet. Assurez-vous de créer une nouvelle branche à chaque fois et de faire des commits réguliers avec des messages clairs et explicatifs.
En mettant en place ces bonnes pratiques, vous pouvez utiliser Github de manière efficace et productive, tout en respectant les normes de qualité et de collaboration nécessaires pour un travail en équipe. N’oubliez pas également de documenter votre projet, d’utiliser les outils de gestion de projet de Github et d’être respectueux et professionnel dans vos interactions avec les autres contributeurs.