# Introduction
Dans les logiciels libres, on peut proposer des modifications (correction de bugs). Si le logiciel est hébergé sur Github ou une autre forge, une procédure doit s'appliquer.

# Prérequis
Il faut un compte sur la plateforme permettant de créer des branches. C'est le cas de Github qui permet de forker des projets : il sera GITHUB-USER dans la suite de la doc.

# Procédure d'exportation
1. Exporter le repository officiel (l'URL est dispo dans l'interface, dans le bouton "Clone").
Attention à ne PAS utiliser son repository perso !
git clone SOURCE-CLONEURL
cd CarnetNextcloud
2. Forker : Cliquer sur le bouton "Fork" du repository officiel. Github nous envoie automatiquement dans le fork, dans son espace
3. Récupérer l'URL de clone dans le fork : FORK-URL
4. Dans le terminal, entrer dans le répertoire du projet (si ce n'était pas fait au 1)
5. Changer la source distante par le fork : git remote add GITHUB-USER FORK-URL

# Modification du code source
1. Mettre tout à jour : git checkout master ; git pull
2. Créer une branche pour ne pas utiliser master : git checkout -b BRANCH-NAME
Vérifier avec d'être dans la branche et que la copie est propre : git status
3. Faire les changements et le commiter :git add filename [filename ...]
git commit
4. Envoyer les modifications : git push GITHUB-USER BRANCH-NAME
5. Demander la pull-request :
Aller sur l'URL fournie dans le push
https://github.com/GITHUB-USER/REPO/pull/new/BRANCH-NAME
OU Aller dans le repository perso, choisir la nouvelle BRANCH-NAME et cliquer
sur "Pull request"
Remplir les détails et envoyer !

# Source
Basé sur https://github.com/asmeurer/git-workflow