Merge branch 'main' of forge.ird.fr:hsm/atelier_amiis/cellule_gee

README.md

 # Cellule_GEE
 
 L'objectif de ce dépôt est de partager les connaissances sur Google Earth Engine au sein de HSM.
-Les utilisateurs de GEE sont encouragés à contribuer en déposant ici les codes qu'ils ont développés, afin d'inspirer d'autres utilisateurs potentiels. Tous les codes sont les bienvenus, la seule requête est d'avoir des codes commentés un minimum afin que d'autres puissent comprendre ce dont il s'agit.
+Les utilisateurs de GEE sont encouragés à contribuer en déposant ici les codes qu'ils ont développés, afin d'inspirer d'autres utilisateurs potentiels. 
 
 ## Introduction à Google Earth Engine
 
@@ -9,35 +9,63 @@ Google Earth Engine est un portail de données disponibles gratuitement sur un c
 
 C'est également une plateforme de calcul qui permet d'effectuer des analyses directement sur les données du catalogue, sans télécharger de données en local.
 
-L'accès à ces services est gratuit pour un usage académique ou de recherche. Il faut simplement créer un compte sur le site. La procédure à suivre est disponible ici https://code.earthengine.google.com/register. 
+L'accès à ces services est gratuit pour un usage académique ou de recherche. Il faut simplement créer un compte sur le
+site. La procédure à suivre est disponible ici https://code.earthengine.google.com/register. 
 
 ## Utilisations de GEE à HSM
 
-Des exemples d'utilisation sont disponibles dans le répertoire `codes_utilisateurs`, incluant des codes utilisant l'API Python et des codes utilisant directement l'interface graphique GEE en Javascript.
+GEE est utilisé à HSM à la fois pour son catalogue de données et pour sa capacité de calcul.
+Des utilisateurs utilisent l'interface Javascript en ligne, d'autres utilisent l'API Python.
+Des exemples d'utilisation sont disponibles dans le répertoire `codes_utilisateurs`.
 
 ## Utilisation du dépôt
 
-# Récupération de codes
+Pour plus d'informations sur l'utilisation de git, voir le wiki :
+ * [Introduction à GIT](https://forge.ird.fr/hsm/atelier_amiis/cellule_gee/-/wikis/Introduction%20git)
+ * [Utilisation simple de GIT](https://forge.ird.fr/hsm/atelier_amiis/cellule_gee/-/wikis/git_simple)
 
-Il est possible de télécharger l'intégralité du dépôt, ie le cloner, ou de télécharger des codes individuels.
+### Téléchargement du dépôt
 
-Cloner le dépôt localement depuis un terminal:
+Toute personne qui peut accéder à cette page peut télécharger le dépôt.
+
+Pour cloner le dépôt localement depuis un terminal :
 
 ```
-git clone 
+git clone  git@forge.ird.fr:hsm/atelier_amiis/cellule_gee.git
 ```
 
-Télécharger un code directement via l'interface graphique.
+Il est également possible de ne télécharger qu'un fichier à la fois, en utilisant directement l'interface graphique de Gitlab.
+
+### Participation
+
+Tous les utilisateurs de GEE sont encouragés à participer en ajoutant leurs codes au dépôt. Tous les codes sont les
+bienvenus, sans exigence de qualité, reproductibilité etc. La seule requête est d'avoir des codes commentés un
+minimum afin que d'autres puissent comprendre ce dont il s'agit. Dans le cas de partage de Jupyter notebook, il est 
+demandé de ne partager que des notebook dont les outputs ont été supprimés, donc avec uniquement les cellules de code.
 
-# Dépôt de codes
+Seuls les utilisateurs membres du repository ont l'autorisation de modifier le dépôt, et donc d'y ajouter des 
+fichiers. Pour demander un accès au dépôt, il faut cliquer sur `Request access` en haut de cette page ou demander 
+à un des membres du repo de les inviter. La liste des membres est accessible via le menu sur la partie gauche de cette 
+page : Project Information > Members.
 
-Pour pouvoir déposer des codes, ie pusher des codes, il faut avoir déjà cloné le repository en local.
+Pour pouvoir déposer des fichiers, il faut avoir préalablement déjà cloné le repository en local, voir ci-dessus.
+
+Une fois le dépôt cloné, il faut :
+ * ajouter le fichier au dépôt local (ie commiter) :
 
 ``` 
-git clone
-git add mycode.py
+git add mycode.xx
 git commit -m "Ajout code XXX"
+```
+ * synchroniser le dépôt local avec le dépôt distant (ie pusher) :
+
+```
 git push
 ```
 
+Le mot de passe Forge IRD sera demandé lors du push vers le répo distant.
+
+Pour se connecter sans mot de passe, voir 
+[la page Wiki "clés SSH""](https://forge.ird.fr/hsm/atelier_amiis/cellule_gee/-/wikis/Cl%C3%A9s%20SSh).
+