Index: trunk/adm/guides/builddoc.rst
===================================================================
--- trunk/adm/guides/builddoc.rst	(revision 114)
+++ trunk/adm/guides/builddoc.rst	(revision 115)
@@ -1,3 +1,8 @@
 .. +
+..
+.. DESCRIPTION
+.. ===========
+..
+.. procedure to build and install doc
 ..
 .. TODO
@@ -11,7 +16,17 @@
 ..
 .. checklink
-.. 
+..
+.. PDF pas encore diffusé car pb numérotation exotique par sphinx de graphiques
+..
 .. EVOLUTIONS
 .. ==========
+..
+.. $Id$
+..
+.. $URL$
+..
+.. - fplod 20120209
+..
+..   * as this file is know cited in index_guide.rst, change section levels
 ..
 .. - fplod 20110628T133328Z aedon.locean-ipsl.upmc.fr (Darwin)
@@ -20,5 +35,5 @@
 ..
 .. - fplod 20110628T132733Z aedon.locean-ipsl.upmc.fr (Darwin)
-.. 
+..
 ..   * add instruction for website
 ..
@@ -34,10 +49,14 @@
 
 Build Documentation
--------------------
+===================
+
+You will find here
+how to build HTML, PDF and troff versions of documentations.
 
 Documentation |project|
-~~~~~~~~~~~~~~~~~~~~~~~
-La documentation est construite à partir des fichiers ReStructuredText_ 
-dans :file:`${TROPFLUX}/adm/` et des commentaires dans les sources 
+-----------------------
+
+La documentation est construite à partir des fichiers ReStructuredText_
+dans :file:`${TROPFLUX}/adm/` et des commentaires dans les sources
 sous :file:`${TROPFLUX}/src/`.
 
@@ -50,22 +69,22 @@
 .. parsed-literal::
 
- $ cd ${|project|}/adm/
- $ make clean
- $ make before
- $ make html_dev_sphinx
+   $ cd ${|project|}/adm/
+   $ make clean
+   $ make before
+   $ make html_dev_sphinx
 
 et regarder le résultat dans :file:`../doc/html/sphinx/index.html`.
 
-Si le résultat est convainquant, on peut produire les autres formats de 
+(bientôt) Si le résultat est convainquant, on peut produire les autres formats de
 documentations (HTML single, PDF et troff):
 
 .. parsed-literal::
 
- $ make all_dev
+   $ make all_dev
 
 Website |project|
-~~~~~~~~~~~~~~~~~
+-----------------
 
-La documentation est construite à partir des fichiers ReStructuredText_ 
+La documentation est construite à partir des fichiers ReStructuredText_
 dans :file:`${TROPFLUX}/adm/website`.
 
@@ -74,16 +93,16 @@
 .. parsed-literal::
 
- $ cd ${|project|}/adm/
- $ make clean
- $ make before
- $ make html_user
+   $ cd ${|project|}/adm/
+   $ make clean
+   $ make before
+   $ make html_user
 
 et regarder le résultat dans :file:`./website/_build/html/index.html`.
 
 Install Documentation |project|
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------------
 
 La mise à disposition des documentations produites ci-dessus sur l'URL
-http://www.locean-ipsl.upmc.fr/~fplod/tropflux/tropflux_ws/doc/html/sphinx/index.html
+http://www.locean-ipsl.upmc.fr/~fplod/tropflux/tropflux_ws/doc/html/sphinx/index.html et sur l'URL http://www.locean-ipsl.upmc.fr/tropflux/
 est réservée à Françoise Pinsard pour des raisons de protections de fichiers et
 de politique de login.
@@ -93,3 +112,3 @@
 .. parsed-literal::
 
- $ make install_all
+   $ make install_all
Index: trunk/adm/guides/contributing.rst
===================================================================
--- trunk/adm/guides/contributing.rst	(revision 114)
+++ trunk/adm/guides/contributing.rst	(revision 115)
@@ -3,4 +3,12 @@
 .. EVOLUTIONS
 .. ==========
+..
+.. $Id$
+..
+.. $URL$
+..
+.. - fplod 20120209
+..
+..   * builddoc move in index_guides.rst
 ..
 .. - fplod 20101220T114420Z aedon.locean-ipsl.upmc.fr (Darwin)
@@ -15,5 +23,5 @@
 
 ==============
- Contributing
+Contributing
 ==============
 
@@ -32,5 +40,2 @@
 You will find in
 :ref:`svn Basic Commands <svnbasiccommands>` how to commit your change
-
-You will find in
-:ref:`builddoc` how to build HTML, PDF and troff versions of documentations.
Index: trunk/adm/guides/updatedata.rst
===================================================================
--- trunk/adm/guides/updatedata.rst	(revision 115)
+++ trunk/adm/guides/updatedata.rst	(revision 115)
@@ -0,0 +1,198 @@
+.. +
+..
+.. DESCRIPTION
+.. ===========
+..
+.. procedure to update data on website
+..
+.. TODO
+.. =====
+..
+.. en fait la comparaison devra être fait aussi AVANT le démarage de cette procédure
+..
+.. translation
+..
+.. comprendre les embrouilles ftp, sftp ncftp www.locean-ipsl.upmc.fr
+..
+.. mettre les sites amis comme le NIO à jour
+..
+.. écrire une doc sur comment ajouter une nouvelle référence
+..
+.. définir les outils de comparaison, écrire les outils en question
+..
+.. tenir compte des images du site dans cette procédure
+..
+.. EVOLUTIONS
+.. ==========
+..
+.. $Id$
+..
+.. $URL$
+..
+.. - fplod 20120209
+..
+..   * creation (draft) with v0 to v1 action
+..
+.. -
+
+.. |project| replace:: TROPFLUX
+.. |project_id| replace:: tropflux
+
+.. _updatedata:
+
+Update data
+===========
+
+On suppose ici que :
+
+ - un nouveau jeu de données est disponible dans un répertoire accessible à partir de cratos.locean-ipsl.upmc.fr (pour faire tourner les outils de validation/comparaison) et à partir du poste de travail (mac) de Françoise Pinsard (pour assure la mise à jour du serveur de données).
+ - (bientôt) des nouvelles images associées sont disponibles dans les mêmes conditions
+
+Le but du jeu de la procédure décrite ici est de :
+
+ - conserver le jeu de données actuel (cf. :ref:`saveold`)
+ - conserver le jeu de données nouveau (cf. :ref:`copynew1` and :ref:`copynew2`)
+ - comparer les deux jeux de données (cf. :ref:`compareversion`)
+ - mettre ce nouveau jeu de données à disposition sous http://www.locean-ipsl.upmc.fr/~tropflux/data/
+ - prévenir les amis de TropFlux (cf. :ref:`advertise`)
+
+.. _newversion:
+
+It must be known if the new dataset is a new version of TropFlux product.
+
+If so, the new version must be described in :file:`changes.rst`.
+(see also :ref:`builddoc` to synchronize dataset and documentation).
+
+If a new field is provided it must be described in :file:`data_out_website.rst`
+
+.. warning::
+
+   embrouille entre les machines (cratos vs mon poste de travail) et les outils (ftp, ncftp, sftp) : on arrive pas toujours à trouver le répertoire  |project_id| après la connexion.
+
+   En conséquence, toutes les commandes ftp sont faites sur le poste de travail (mac) de Françoise Pinsard.
+
+.. note::
+
+   Here is the sequence of commands to be run to create
+   the directory equivalent to the URL  http://www.locean-ipsl.upmc.fr/~tropflux/images/
+
+   .. parsed-literal::
+   
+      fplod@sonmac$ ftp www.locean-ipsl.upmc.fr
+      ftp> cd |project_id|
+      ftp> mkdir images
+
+La mise à disposition des fichiers de données et des images sur l'URL
+http://www.locean-ipsl.upmc.fr/tropflux/
+est réservée à Françoise Pinsard pour des raisons de protections de fichiers et
+de politique de login.
+
+.. _saveold:
+
+Save old version
+----------------
+
+.. parsed-literal::
+
+   $ datemodif="20120209"
+   $ export datemodif
+   $ cd /usr/lodyc/incas/fplod/tropflux_d/
+   $ mkdir obsolete_${datemodif}
+
+.. parsed-literal::
+
+   $ mv ./daily obsolete_${datemodif}
+   $ mv ./monthly obsolete_${datemodif}
+
+.. _copynew1:
+
+Copy new version (phase 1)
+--------------------------
+
+.. parsed-literal::
+
+   $ newdir='/net/adonis/usr/adonis/varclim/tropflux_v1'
+   $ export newdir
+   $ cp -r ${newdir}/daily /usr/lodyc/incas/fplod/tropflux_d/to_be_published
+   $ cp -r ${newdir}/monthly /usr/lodyc/incas/fplod/tropflux_d/to_be_published
+
+(here is not the final state ...)
+
+.. _compareversion:
+
+Compare versions
+----------------
+
+A set of tools must be run to compare obsolete and new versions
+
+TDB
+
+.. parsed-literal::
+
+   $ ++compare.sh -o obsolete_${datemodif} -n /usr/lodyc/incas/fplod/tropflux_d/to_be_published
+
+Once comparison is done and PI happy,
+++ cleanning or modify newdir
+
+.. _copynew2:
+
+Copy new version (phase 2)
+--------------------------
+
+.. parsed-literal::
+
+   $ cd /usr/lodyc/incas/fplod/tropflux_d/
+   $ mv ./to_be_published/daily ./
+   $ mv ./to_be_published/monthly ./
+
+
+.. _desinstalldata:
+
+Remove old version from the website
+-----------------------------------
+
+To avoid confusion, old version has to be removed from the website:
+
+.. parsed-literal::
+
+   fplod@sonmac$ ftp www.locean-ipsl.upmc.fr
+   ftp> cd |project_id|/data/
+   ftp> mdelete daily/*
+   ftp> mdelete monthly/*
+
+.. _installdata:
+
+Installation of the new version
+-------------------------------
+
+L'installation se fait ainsi:
+
+.. parsed-literal::
+
+   fplod@sonmac$ cd /Volumes/Lcerbere/tropflux_d/
+   ftp> cd |project_id|/data/
+   ftp> cd daily
+   ftp> lcd daily
+   ftp> mput *.nc
+   ftp> cd ../monthly
+   ftp> lcd ../monthly
+   ftp> mput *.nc
+
+.. note::
+
+   :file:`/Volumes/Lcerbere/tropflux_d/` is equivalent to file:`/usr/lodyc/incas/fplod/tropflux_d/` thanks to sshfs command.
+
+   .. parsed-literal::
+   
+      $ diskext="/Volumes/LCerbere"
+      $ sshfs fplod@cerbere:/usr/lodyc/incas/fplod ${diskext} -odefer_permissions
+
+.. _advertise:
+
+Advertise TropFlux friends
+--------------------------
+
+A email must be send to TropFlux list to warn about the new dataset.
+
+Une mise à jour doit être envoyée aux contacts dans les instutions qui mentionne notre jeu de données (NIO).
+
Index: trunk/adm/index_guides.rst
===================================================================
--- trunk/adm/index_guides.rst	(revision 114)
+++ trunk/adm/index_guides.rst	(revision 115)
@@ -11,4 +11,11 @@
 .. ==========
 ..
+.. $Id$
+..
+.. $URL$
+..
+.. - fplod 20120209
+..
+..   * add builddoc and updatedata
 ..
 .. - fplod 20101122T171327Z aedon.locean-ipsl.upmc.fr (Darwin)
@@ -29,4 +36,6 @@
 
    guides/data_content
+   guides/updatedata
+   guides/builddoc
    guides/coding_rules
 
