diff --git a/example.yaml b/example.yaml
index a883218..151461c 100644
--- a/example.yaml
+++ b/example.yaml
@@ -1,80 +1,87 @@
-# -----------------------------------------------------------------------------
-# Date fin du mois pour le script
-# Fin avril fin commit
-# Fin aout
-# ----------------------------------------------------------------------------
-
 global:
-  user_db_cache: "cache.yaml"
-  all: [svn, git]
-  use_keyring: true
+  user_db_cache: "cache.yaml"   # file to save ldap queries to
+  all: [svn, git]               # Only migrate one type of repo
+  use_keyring: true             # Save your password for each repo access
   in:
-    backend: epfl
-    username: richart
+    # Source of the repositories
+    backend: epfl               # only epfl backend implemented
+    username: richart           # gaspar username
 
   out:
 #    backend: c4science
     backend: phabricator
     username: richart-test
     host: https://scitassrv18.epfl.ch/
     token: cli-n5dutb2wv26ivcpo66yvb3sbk64g # API token obtain in the settings
 
 groups:
   __all__:
     import-scheme:
+      # Global project options
       type: sub-project # or project
+                        # if sub-project, specify a project to import the group
+                        # to. If set to project, will create one project per group
       project: test_import # only for sub-project type
-      name: test_{original_name}
+      name: test_{original_name} # if you want to prefix or suffix your Project
 
   scitas-ge-unit:
+    # Specific to one project of your choice
     import-scheme:
       type: project
       name: scitas-ge
 
-  hpc-lsms:
+  hpc-lsms: # this will created the project if no repo is given, otherwhise
+            # will inherit from __all__ import-scheme
 
   lsms-unit:
+    # Example of a EPFL unit to import as lsms Project
     import-scheme:
       name: lsms
 
 repositories:
   __all__:
-    type: git
+    # __all__ is the default for other repo, you can override this in each repo
+    type: git # svn | git (default git)
     import-scheme:
-      type: same #| git | svn
-      name: gms_{original_name}
+        type: same # git | svn # the type to migrate to
+                   # (only git->git, svn->svn and svn->git are supported)
+      name: gms_{original_name} # default: '{original_name}'
       permissions:
         scheme: import #| project | user | static
-        # project: name -> tag to add
-        # view: <proj_name> | _author_ | _public_ | _users_
-        # push: <proj_name> | _author_ | _public_ | _users_
-        # edit: <proj_name> | _author_ | _public_ | _users_
+        # Project
+        #  Set the repo policy to a Project name
+        #
+        # User
+        #  Set the repo policy to a single username
+        #
+        # Import (default)
+        #   
+        # Project: name -> tag to add
+        #  view: <proj_name> | _author_ | _public_ | _users_
+        #  push: <proj_name> | _author_ | _public_ | _users_
+        #  edit: <proj_name> | _author_ | _public_ | _users_
 
   iohelper:
     import-scheme:
       branches: [master]
       tags: []
       permissions:
         view: _public_
         push: _users_
         edit: lsms
 
   toto:
 
   akantu:
     import-scheme:
       branches: [master]
       tags: []
 
-  test-interface:
+  test:
     type: svn
     import-scheme:
       permissions:
         scheme: project
         project: scitas-ge
         view: _public_
 
-
-#      partial-import: /path
-#      branches: [] # if not specified all are imported
-#      tags: [] # if not specified all are imported