From ec4f57ec5b456dd893a7737bd8b507181f8be102 Mon Sep 17 00:00:00 2001
From: NightPumpkin <nightpumpkin@noreply.org>
Date: Fri, 26 Feb 2021 20:33:35 +0100
Subject: [PATCH] =?UTF-8?q?Cr=C3=A9ation=20README=5FGIT?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README_GIT.md | 115 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 115 insertions(+)
 create mode 100644 README_GIT.md

diff --git a/README_GIT.md b/README_GIT.md
new file mode 100644
index 0000000..5b5b9f5
--- /dev/null
+++ b/README_GIT.md
@@ -0,0 +1,115 @@
+# AIDE POUR LE REPO
+
+## Table des matières  
+* [Comment utiliser Git](#wiki)
+* [Docker-compose](#docker-compose)
+* [Wiki](#wiki)
+
+## Comment utiliser Git
+
+Clonez le dépot sur votre machine `git clone https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo.git`  
+
+### Pour chaque modification, attention à bien suivre cette procédure si vous voulez éviter des conflits de versions
+
+- Créez votre branche via la GUI Gitea (idéalement votre pseudo) ex : `Benj`
+
+![mabanche](https://i.imgur.com/0KLNFSG.png)
+
+- Rapatriez les dernières modifications : `git pull`
+- Mettez vous sur votre branche : `git checkout mabranche`
+- Faites vos modificatiosn (création de fichiers etc)
+- Récupérez les éventuelles denrières modifications : `git pull` puis `git merge master`
+- Ajoutez les nouveaux fichiers : `git add .` ou `git add -A` 
+- Validez les modif : `git commit -m "ma super modif"`
+- Balancez sur le serveur : `git push`
+- Et ouvrez une pull request via la GUI
+
+
+Quand la pull request est close et/ou mergé, pensez à supprimer votre branche, 
+vous pourrez la recréer plus tard quand vous aurez besoin...
+
+### Petit reminder
+
+- **ON NE TRAVAILLE JAMAIS SUR LE MASTER**
+
+- **Un renommage de répertoire cause un conflit généralement, nécessite intervention manuelle**
+
+- `git status` > donne la branche courante ainsi que l'état des fichiers modifiés
+> git status  
+> Sur la branche master  
+> Votre branche est à jour avec 'origin/master'.  
+>  
+> Modifications qui ne seront pas validées :  
+>  (utilisez "git add <fichier>..." pour mettre à jour ce qui sera validé)  
+>  (utilisez "git checkout -- <fichier>..." pour annuler les modifications dans la copie de travail)  
+>
+>	modifié :         README.md
+>
+> aucune modification n'a été ajoutée à la validation (utilisez "git add" ou "git commit -a")
+
+
+- `git add toto.pouet` ou `git add .` > ajout les modifications sur toto.pouet ou sur tous les fichiers au prochain commit
+
+
+- `git commit -m "mon super message"` > on pose le commit avec un message qui explique ce que l'on a fait (pratique pour retrouver ca plus tard si besoin)
+
+
+- `git pull` > on récupère toutes les dernières modifs du serveur
+
+
+- `git merge master` > (doit être fait après un `git pull`) on récupère toutes les dernières modifs du master pour les mettre sur la branche courante
+
+### Au secours
+
+#### J'ai fait mes modif sur le master (sans commit)
+
+- `git stash` > je sauvegarde mes modifs en local et rétablis le dernier commit
+- `git pull` > je récupère des dernières modifs du serveur
+- `git checkout mabranche` > je changement de branche
+- `git merge master` > je récupère les dernières modifs du master sur ma branche
+- `git stash apply` > j'applique ma sauvegarde local
+- je poursuis mes modifs et je add/commit/push quand j'ai fini
+
+## Docker-compose
+
+### Fonctionnement
+
+Le répertoire `docker-compose/` contient uniquement les docker-compose de chaque service/application.  
+
+L'arborescence doit être la suivante :  
+`docker-compose/<app>/docker-compose.yml`  
+- `<app>` : le nom de l'application ou service à rajouter
+
+### Possibilité
+
+Le bot pourrait appeler le contenu de chaque application selon cette commande
+`.docker-compose <app>`  
+Il chercherait selon l'url suivant :
+`https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/master/docker-compose/<app>/docker-compose.yml`  
+Si HTTP 200 alors on affiche le contenu retourné  
+Sinon HTTP 404 alors on affiche `la page n'existe pas`  
+
+
+Exemple ok:
+> `.docker-compose plex`
+> renvoie le contenu de
+> https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/master/docker-compose/plex/docker-compose.yml
+
+Exemple ko:
+> `.docker-compose pouet`
+> renvoie `La page que vous demandez n'existe pas`
+
+
+
+## Wiki
+
+fichiers au format md (markdown)
+
+### Possibilité
+
+Le bot pourrait appeler le contenu de chaque application selon cette commande
+`.wiki <doc>`  
+Il chercherait selon l'url suivant :
+`https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/master/wiki/<doc>.md`  
+Si HTTP 200 alors on affiche le contenu retourné  
+Sinon HTTP 404 alors on affiche `la page n'existe pas`  
\ No newline at end of file