images forks

branches.md

@@ -6,7 +6,7 @@ output:
 
 * * * * *
 
-# Branches (travailler en équipe)
+# Branches 
 
 TODO
 

depot_distant.md

@@ -6,7 +6,7 @@ output:
 
 * * * * *
 
-# Dépôt distant (sauvegarder un projet sur un serveur)
+# Dépôt distant 
 
 Git permet de synchroniser un dépôt local avec un dépôt distant (sur un
 serveur).  Ceci permet d'envoyer les commits locaux sur le serveur et de
@@ -48,11 +48,18 @@ section suivante).
 
 ![](depot_distant_05.png)
 
+TODO : collaboration
+
+![](depot_distant_15.png)
+
 ## Cloner un dépôt distant vers un nouveau dépôt local
 
 La commande `git clone ...` permet de récupérer un dépôt distant sur votre
-machine (cf image ci-dessous). Pensez à mettre votre login après le "https://"
-(pour vous éviter d'avoir à le retaper sans arrêt, plus tard).
+machine (cf image ci-dessous). 
+
+Pour éviter d'avoir à retaper votre login sans arrêt, pensez à l'ajouter après
+le "https://" lors du clone. Vous pouvez également l'ajouter plus tard, dans le
+fichier `.git/config`. 
 
 ![](depot_distant_06.png)
 

depot_local.md

@@ -6,10 +6,10 @@ output:
 
 * * * * *
 
-# Dépôt local (journaliser un projet)
+# Dépôt local 
 
 L'élément de base d'un projet git est le dépôt. Il s'agit simplement d'un
-dossier classique que l'on demande à git de versionner.
+dossier classique que l'on demande à git de versionner (journaliser).
 
 Un dépôt git contient l'ensemble des commits (versions sauvegardées du projet).
 Ces commits peuvent être marqués par des étiquettes. Il existe deux étiquettes
@@ -44,7 +44,7 @@ notre projet.
 
 ![](depot_local_03.png)
 
-On y écrit du code latex.
+On y écrit du code LaTeX.
 
 ![](depot_local_04.png)
 
@@ -111,7 +111,7 @@ changé), ce qui est inefficace.
 
 D'autre part, il est inutile de versionner les fichiers autogénérés (créés
 automatiquement lors de la compilation du code). Par exemple, si on compile le
-code latex de notre projet...
+code LaTeX de notre projet...
 
 ![](depot_local_12.png)
 

forks.md

@@ -14,6 +14,22 @@ TODO
 
 ## Envoyer un pull request
 
+![](forks_01.png)
+![](forks_02.png)
+![](forks_03.png)
+![](forks_04.png)
+![](forks_05.png)
+![](forks_06a.png)
+![](forks_06b.png)
+![](forks_06c.png)
+![](forks_07.png)
+![](forks_08.png)
+![](forks_09.png)
+![](forks_j10.png)
+![](forks_j11.png)
+![](forks_j12.png)
+![](forks_j13.png)
+
 ## Résumé et méthode de travail
 
 Résumé des commandes git précédentes :

index.md

@@ -13,32 +13,42 @@ output:
   gogs](https://gogs.univ-littoral.fr) mis en place par le
 [SCOSI](http://scosi.univ-littoral.fr/). 
 - Pré-requis : utilisation basique d'un ordinateur (et notamment du clavier).
-- Public visé : les développeurs au sens large (code latex, python, matlab, R,
-  java...) qui souhaitent journaliser et/ou partager du code.
+- Public visé : toute personne ayant à manipuler, journaliser ou partager des
+  fichiers de texte brut (txt, LaTeX, python, matlab, R, java, CSV...). 
 
 ## Qu'est-ce-que git et gogs ?
-- git : système décentralisé de journalisation de code source (alternative à
+- git : système décentralisé de journalisation de fichiers (alternative à
   mercurial, subversion, CVS...)
-- gogs : service d'hébergement de code source utilisable avec git (alternative
+- gogs : service d'hébergement de fichiers utilisable avec git (alternative
   à github, bitbucket...)
 
 ## Dans quels cas utiliser git/gogs ?
-git est conçu pour manipuler principalement des fichiers **au format texte**
-(code source, code latex, fichier CSV...). Attention, les fichiers word, excel
-et PDF ne sont pas des fichiers au format texte.
-
-Quelques fonctionnalités de git :
-
-- journalisation 
-- sauvegarde distante 
-- synchronisation 
-- travail en équipe 
-- projets publics ou privés :
+Git est conçu pour manipuler principalement des fichiers **au format texte**
+(code source, code LaTeX, fichier CSV...). Attention, les fichiers word, excel
+et PDF ne sont pas des fichiers au format texte et git est beaucoup moins
+intéressant pour manipuler ce genre de fichiers.
+
+Quelques fonctionnalités/utilisation de git/gogs :
+
+- **journalisation** : « je modifie souvent mes fichiers et je peux revenir à
+  mes modifications précédentes, les annuler ou en tester plusieurs en
+parallèle »
+- **sauvegarde distante** : « quand je le souhaite, l'outil envoie une copie de
+  sauvegarde de mes fichiers sur un serveur ».
+- **synchronisation** : « je travaille sur plusieurs postes différents et je
+  peux synchroniser mes fichiers facilement entre les postes ».
+- **travail en équipe** : « mes collègues et moi travaillons sur des fichiers
+  communs; les modifications de chacun sont retransmises aux autres; les
+éventuels conflits sont détectés (quand un fichier est modifié par deux
+personnes en même temps) ».
+- **projets publics ou privés** : « je peux créer des projets publics, visibles
+  par tout le monde sur internet (ou uniquement de l'université), et des
+projets privés, visibles et modifiables par les collègues que j'indique ».
 
 ## Dans quels cas ne pas utiliser git/gogs ?
 - édition collaborative en temps-réel -> sharelatex
-- partage de fichiers -> serveur ftp, http...
-- fichiers dans un format non textuel (word, excel, PDF...) -> dropbox
+- partage de fichiers -> dropbox, serveur FTP/HTTP...
+- fichiers dans un format non textuel (word, excel, PDF...) 
 
 ## Concepts de base