Collaboration avec Git

Dans le terminal

Basculer sur la branche principale (main)

git checkout main

Explication : Cette commande vous positionne sur la branche main. Elle est utile pour vous assurer de commencer à partir de la dernière version stable du code.

Récupérer les dernières modifications de la branche principale

git pull origin main

Explication : Cette commande télécharge les dernières modifications depuis le dépôt distant sur la branche main. Elle assure que votre version locale est à jour avant de créer une nouvelle branche de travail.

Créer une nouvelle branche de travail

git branch nom-de-votre-branche
git checkout nom-de-votre-branche

Alternative : En une seule commande :

git checkout -b nom-de-votre-branche

Explication : Ces commandes créent une nouvelle branche (appelée nom-de-votre-branche) et vous y basculent. La nouvelle branche est basée sur la branche main actuelle.

Enregistrer les modifications

git add .
git commit -m "Description des modifications"

Explication :

• git add . : Prépare toutes les modifications pour le commit.
• git commit -m "Description des modifications" : Enregistre les modifications dans l’historique Git local avec un message de description.

Pousser les modifications sur le dépôt distant

git push origin nom-de-votre-branche

Explication : Cette commande envoie les modifications de votre branche locale vers le dépôt distant, créant ou mettant à jour la branche nom-de-votre-branche sur le dépôt distant.

Création de la Merge Request

Après avoir poussé vos modifications sur la branche distante, procédez à la création d’une Merge Request sur votre plateforme Git.

Si la requête est validée, vous pourrez ainsi fusionner votre branche avec la branche main.

Créer une Merge Request sur GitHub, GitLab, ou autre:

• Sélectionnez la branche source comme étant nom-de-votre-branche.
• Choisissez main comme branche de destination.
• Ajoutez une description détaillée de vos modifications.
• Assignez des reviewers si nécessaire pour qu’ils puissent valider le code.

---

Avec Source Control (VSCode)

La partie suivante couvre exactement la même procédure, mais cette fois avec Source Control dans VSCode.

Basculer sur la branche principale (main)

1. Cliquez sur le sélecteur de branches en bas à gauche. Il est composé du logo de Source Control et du nom de la branche actuelle.
2. Sélectionnez la branche main dans la liste.

Récupérer les dernières modifications de la branche principale

1. Cliquez sur l’icône “Source Control” dans la barre latérale.

2. Cliquez sur les trois points (…) puis sur clone.

3. Choisissez votre dépôt git.

Créer une nouvelle branche de travail

1. Cliquez sur le nom de la branche en bas à gauche.
2. Sélectionnez ”+ Create new branch” ou choissisez le nom de la branche.

Enregistrer les modifications

1. Ouvrez Source Control.

2. Cliquez sur le ”+” pour stage les changements. Les fichiers passent dans “Staged Changes”

3. Entrez votre message de commit dans la zone de texte, puis cliquez sur “Commit”.

4. Cliquez sur “Sync Changes” pour synchroniser.

Pousser les modifications sur le dépôt distant

1. Après le commit, cliquez sur “OK” dans la boîte de dialogue de synchronisation.

Création de la Merge Request

Même procédure que dans la partie “Dans le terminal”.

Bonnes Pratiques

1. Toujours partir d’une branche main à jour (utiliser la commande pull).
2. Créer une nouvelle branche pour chaque fonctionnalité ou correction.
3. Écrire des messages de commit clairs et descriptifs.
4. Vérifier les modifications avant le commit.
5. Synchroniser régulièrement avec le dépôt distant.

Note Importante

Cette documentation couvre les commandes de base pour un workflow Git standard. Pour des opérations plus avancées ou des cas particuliers, consultez la documentation officielle de Git ou votre administrateur système.