MedTree - Git & Github

Gestion de projet & issues

Prodédure pour dev une fonctionnalitée / régler un problème

Créer issue & milestone

Milestone:

• Objectif à atteindre pour une date
• On y inscrit plusieurs issue (= petite étape à réaliser pour atteindre l'objectif)

Dans Github: Issue --> Milestone

• S'il n'existe pas de Milestone on en crée une
• Sinon on crée une Issue dans la Milestone existante correspondente En créant une issue, il faut remplir: title, comment, assignees, projects et milestone

Remarque: Les issues crées apparaissent directement dans les tâches à réaliser.
Un id est présent après le titre de l'issue de la forme: #nombre

Pull request

Quand je commence à coder un nouveau point

Pull le repo origin pour avec la dernière version:
git pull origin main

Créer une nouvelle branche avec pour nom l'issue:
git checkout -b branch_name

Quand j'ai finis de coder

Ajouter les changements avant de commit:
git add -A

Commit avec l'id de l'issue:
git commit -m "fixed issue #id"

Avant de merge au main on s'assure que notre version est à jour:
git pull origin main

Créer une pull request sur GitHub

• Depuis la page "code"
• Depuis "banches" en cliquant sur "new pull request" (sur la bonne branch)

GitHub vérifie s'il est possible de merge sans conflit. Si possible un message vert apparaît et il est possible de valider la pull request (si l'utilisateur à bien les droits).
Cependant il vaut mieux squash le merge. Cela permet de n'ajouter qu'un seul commit dans le main. Peut importe le nombre de commit de la branch à fusionner. Ces commits resteront quand même dans l'historique de la pull request
Une fois ceci terminer un bouton supprimer la branch est disponible.

Une fois le merge fait sur github, on peut mettre à jour notre local repository:
git pull origin main
git checkout main
git branch -D branch_name

Une fois qu'on a fini de travailler sur l'issue on peut se rendre sur github dans "issues" et fermer l'issue

En cas de merge conflit

Au moment de git pull origin main: Un message devrai apparaitre en idiquant le/ les conflit. Une fois résolu:

git add -A
git commit -m "conflic resolved"
git push

La pull request sera mise à jour et pourra être validée

Command git utile:

Branch

Lister le nom des branch locals:
git branch

Lister le nom des remote branch:
git branch -r

Lister le nom des branch local & remote:
git branch -a

Lister les info sur les branch remote / local:
git branch -vv
git branch -vva