--- a/server/python/django2/renkanmanager/docs/index.md	Tue Jun 21 10:30:08 2016 +0200
+++ b/server/python/django2/renkanmanager/docs/index.md	Tue Jun 21 17:53:06 2016 +0200
@@ -6,10 +6,10 @@
 
 ##### Renkan
 
-L'objet Renkan est le principal point d'entrée de l'API.    
+L'objet Renkan est le principal point d'entrée de l'API.
 Chaque Renkan est associé à au plus un workspace et au moins une révision
 
-* Représentation JSON   
+* Représentation JSON
 
 ```sh
     {
@@ -29,33 +29,33 @@
 
 ##### Révisions
 
-Une révision représente l'état d'un renkan à un instant donné.    
-Chaque révision est associé à un unique Renkan. Lorsqu'un renkan est modifié, on peut soit altérer la révision courante, soit créer une nouvelle révision. La dernière révision d'un renkan donné créée est la "révision courante" de ce renkan.    
+Une révision représente l'état d'un renkan à un instant donné.
+Chaque révision est associé à un unique Renkan. Lorsqu'un renkan est modifié, on peut soit altérer la révision courante, soit créer une nouvelle révision. La dernière révision d'un renkan donné créée est la "révision courante" de ce renkan.
 
-C'est au niveau de l'objet Révision que sont stockées les informations de titre et de contenu d'un Renkan. 
+C'est au niveau de l'objet Révision que sont stockées les informations de titre et de contenu d'un Renkan.
 
-* Représentation JSON   
+* Représentation JSON
 
 ```sh
     {
     	"id" : id de la revision
     	"title" : titre de la revision
     	"content" : contenu (JSON) de la revision
-    	"parent_renkan_id" : id du renkan associé à la révision 
-    	"workspace_id" : si le renkan associé à la révision est assigné à un workspace, 
+    	"parent_renkan_id" : id du renkan associé à la révision
+    	"workspace_id" : si le renkan associé à la révision est assigné à un workspace,
     	id du workspace du renkan,
     	"renkan_created_by" : username du créateur du renkan
     	"renkan_last_updated_by" : username du dernier utilisateur à avoir modifié le renkan
     	"revision_created_by" : username du créateur de la révision
-    	"revision_last_updated_by" : username du dernier utilisateur à avoir modifié la révision	
+    	"revision_last_updated_by" : username du dernier utilisateur à avoir modifié la révision
     	"revision_modification_date" :  date de dernière modification de la révision
     }
 ```
 
 ##### Workspaces
-Un workspace (ou espace) renkan est une structure (optionnelle) regroupant un ou plusieurs renkans. 
+Un workspace (ou espace) renkan est une structure (optionnelle) regroupant un ou plusieurs renkans.
 
-* Représentation JSON   
+* Représentation JSON
 
 ```sh
    {
@@ -70,7 +70,8 @@
 ### Liste exhaustive des endpoints de l'API
 
 #### Endpoints Renkan
-1. **Créer un Renkan**    
+
+##### 1. Créer un Renkan
 ```POST /renkan-api/renkans/```
 
 Données à passer en JSON (facultatif):
@@ -85,22 +86,22 @@
 
 Si succès: Renvoie ```201 CREATED``` et le json associé au renkan créé
 
-2. **Dupliquer un Renkan**    
-```POST /renkan-api/renkans/?source_renkan_id=<:renkan_id>```    
+##### 2. Dupliquer un Renkan
+```POST /renkan-api/renkans/?source_renkan_id=<:renkan_id>```
 
 Données à passer en JSON:
 ```
 {
 	"title": titre de la copie (facultatif)
 }
-```    
+```
 
 **Note:** Dans l'implémentation actuelle, si la donnée "title" n'est pas fournie, le titre du renkan copié sera identique au titre du renkan source.
 
-Si succès: renvoie ```201 CREATED``` et le json décrivant le renkan créé.    
+Si succès: renvoie ```201 CREATED``` et le json décrivant le renkan créé.
 Si échec: renvoie un ```404 NOT FOUND``` si ```<:renkan_id>``` ne correspond à aucun renkan existant
 
-3. **Modifier un Renkan**    
+##### 3. Modifier un Renkan
 ```PUT /renkan-api/renkans/<:renkan_id>```
 
 Données à passer en JSON:
@@ -110,55 +111,61 @@
 }
 ```
 
-Si succès: renvoie ```200 OK``` et le json associé au renkan modifié    
+###### Paramêtres de requête
+- **```validation_timestamp```** : date (urlencodée) au format ISO8601 correspondant à valeur du champ ```updated``` du contenu du renkan à modifier. Est utilisé pour vérifier que le renkan cible n'ai pas été modifié entre 2 requêtes.
+- **```create_new_revision```** : Force la création d'une nouvelle révision pour le Renkan. Si ```false```, la révision counrant est mise à jour. ```false``` par défaut.
+- **```content_only```** : Retourne seulement le contenu du renkan dans le reeponse, et pas les métadata.
+
+Si succès: renvoie ```200 OK``` et le json associé au renkan modifié
 Si échec:  renvoie un ```404 NOT FOUND``` si ```<:renkan_id>``` ne correspond à aucun renkan existant.
 
-4. **Obtenir la liste des Renkan**  
+##### 4. Obtenir la liste des Renkan
 ```GET /renkan-api/renkans/```
 
 Renvoie la liste des renkans auxquels l'utilisateur authentifié a accès en lecture.
 
 Si succès: Renvoie ```200 OK```et une liste où chaque élément correspond à un json de renkan.
 
-5. **Obtenir les informations sur un Renkan**    
-```GET /renkan-api/renkans/<:renkan_id>```    
+##### 5. Obtenir les informations sur un Renkan
+```GET /renkan-api/renkans/<:renkan_id>```
 
-Si succès: renvoie ```200 OK``` et le json associé au renkan requêté    
+Si succès: renvoie ```200 OK``` et le json associé au renkan requêté
 Si échec: renvoie ```404 NOT FOUND``` si ```<:renkan_id>``` ne correspond à aucun renkan existant.
 
-6. **Supprimer un renkan**  
+##### 6. Supprimer un renkan
 ```DELETE /renkan-api/renkans/<:renkan_id>```
 
-Si succès: renvoie ```204 NO CONTENT```     
+Si succès: renvoie ```204 NO CONTENT```
 Si échec: renvoie un ```404 NOT FOUND``` si ```<:renkan_id>``` ne correspond à aucun renkan existant.
 
 #### Endpoints Révision
-1. **Obtenir la liste des révisions pour un Renkan donné**	
+
+##### 1. Obtenir la liste des révisions pour un Renkan donné
 ```GET /renkan-api/renkans/<:renkan_id>/revisions/```
 
-Si succès: Renvoie ```200 OK``` et une liste où chaque élément est un json correspondant à une révision.    
+Si succès: Renvoie ```200 OK``` et une liste où chaque élément est un json correspondant à une révision.
 Si échec: Renvoie un ```404 NOT FOUND``` si le ```<:renkan_id>``` ne correspond à aucun renkan existant
 
-2. **Obtenir les informations sur une révision**    
+##### 2. Obtenir les informations sur une révision
 ```GET /renkan-api/renkans/<:renkan_id>/revisions/<:revision_id>```
 
-Si succès: renvoie ```200 OK``` et le json associé à la révision requêtée     
+Si succès: renvoie ```200 OK``` et le json associé à la révision requêtée
 Si échec: renvoie un ```404 NOT FOUND``` si ```<:renkan_id>``` ne correspond à aucun renkan existant ou que ```<:revision_id>``` ne correspond à aucune révision existante.
 
-3. **Supprimer une révision**   
+##### 3. Supprimer une révision
 ```DELETE /renkan-api/renkans/<:renkan_id>/revisions/<:revision_id>```
 
 **Note:** il est impossible de supprimer la "révision courante" d'un renkan.
 
-Si succès: renvoie ```204 NO CONTENT```  
+Si succès: renvoie ```204 NO CONTENT```
 Si échec: renvoie un ```404 NOT FOUND``` si ```<:renkan_id>``` ne correspond à aucun renkan existant ou si ```<:revision_id>``` ne correspond à aucune révision existante
 
 #### Endpoints Workspace
-1. **Créer un Workspace**   
+##### 1. Créer un Workspace
 ```POST /renkan-api/workspaces/```
 
 Données à fournir en JSON (facultatif):
-``` 
+```
 {
     "title": titre du workspace à créer
 }
@@ -166,7 +173,7 @@
 
 Si succès: Renvoie ```201 CREATED``` et le json associé au workspace créé
 
-2. **Créer un Renkan dans un Workspace donné**  
+##### 2. Créer un Renkan dans un Workspace donné
 ```POST /renkan-api/workspaces/<:workspace_id>/renkans/```
 
 Données (facultatif):
@@ -179,34 +186,32 @@
 
 **Note:** Si aucun titre n'est fournie le renkan sera intitulé "Untitled Renkan". Si aucun contenu n'est fourni un JSON minimal sera généré
 
-Si succès: Renvoie ```201 CREATED``` et le json associé au renkan créé  
+Si succès: Renvoie ```201 CREATED``` et le json associé au renkan créé
 Si échec: Renvoie un ```404 NOT FOUND``` si le ```<:workspace_id>``` ne correspond à aucun workspace exis-tant
 
-3. **Obtenir la liste des Workspaces**  
+##### 3. Obtenir la liste des Workspaces
 ```GET /renkan-api/workspaces/ ```
 
 Si succès: renvoie ```200 OK``` et une liste où chaque élément est un json correspondant à un workspace.
 
-4. **Obtenir la liste des Renkan associé à un Workspace donné**     
+##### 4. Obtenir la liste des Renkan associé à un Workspace donné
 ```GET /renkan-api/workspace/<:workspace_id>/renkans/```
 
 Renvoie la liste des renkans (associés au workspace) auxquels l'utilisateur authentifié a accès en lecture.
 
-Si succès: Renvoie ```200 OK``` et une liste où chaque élément correspond à un json de renkan.    
+Si succès: Renvoie ```200 OK``` et une liste où chaque élément correspond à un json de renkan.
 Si échec: Renvoie un ```404 NOT FOUND``` si le ```<:workspace_id>``` ne correspond à aucun workspace exis-tant
 
-5. **Obtenir les informations sur un Workspace**    
+##### 5. Obtenir les informations sur un Workspace
 ```GET /renkan-api/workspaces/```
 
-Si succès:renvoie ```200 OK``` et une liste où chaque élément est un json correspondant à un workspace.    
+Si succès:renvoie ```200 OK``` et une liste où chaque élément est un json correspondant à un workspace.
 Si échec: renvoie un ```404 NOT FOUND``` si le ```<:workspace_id>``` ne correspond à aucun workspace existant
 
-6. **Supprimer un Workspace**   
+##### 6. Supprimer un Workspace
 ```DELETE /renkan-api/workspaces/<:workspace_id>```
 
 Note: il est impossible de supprimer un workspace s'il reste au moins un renkan assigné à celui-ci.
 
-Si succès: renvoie ```204 NO CONTENT```     
-Si échec: renvoie un ```404 NOT FOUND``` si le ```<:workspace_id>``` ne correspond à aucun workspace existant 
-
-
+Si succès: renvoie ```204 NO CONTENT```
+Si échec: renvoie un ```404 NOT FOUND``` si le ```<:workspace_id>``` ne correspond à aucun workspace existant