release_notes.md

 # Release notes #
 
-But at the very least this page aims at keeping providing information regarding the change of function or arguments name within
-the different versions of LMGC90. Thus they are not release notes 'stricto sensu' yet !
+This page aims at keeping major information regarding the changes of function names, argument names or whatever between
+the different versions of LMGC90. This is not release notes 'stricto sensu'.
 
 * [2015->2016](#2016)
 
 ## <a name=2016> version 2016 ##
 
-There are a lot of changes concerning the **pre**, thus a script is provided in *lmgc90_user/src/addons* attempting to
-update a single script or all python script in a directory tree.
+There are several changes concerning the **pre** python module. 
+Remember that script is provided in *lmgc90_user/src/addons* attempting to update a single script or all python scripts in a directory tree.
 
  If  *lmgc90_user/src/addons* is in your `$PATH` environment variable, run:
 ```shell
@@ -17,15 +17,15 @@ update_gen_2016.py gen_sample.py
 To update *gen_sample.py* script. You can replace the script name by a directory to try to update all python scripts in it.
 There are cases where the script may fail, here is the list of changes so that you can correct you scripts yourself:
 
-* change of submodule of `pylmgc90` changed from`pre_lmgc`to `pre`
-* in `tact_behav` constructor: `type` is replaced by `law`
-* in `model` constructor: `type` is replaced by `physics`
-* in `material` constructor: `type` is replaced by `materialType`
-* in `avatar.addContactors` method : `type` is replaced by `shape`
-* in `avatar.rotate` method: `type` is replaced by `description`
-* in `avatar.imposeDrivenDof` method: `type` is replaced by `description`
-* in `postpro_command' constructor: `type` is replaced by `name`
-* in `buildMesh2D` function: `type_mesh` is replaced by `mesh_type`
-* in `avatar` constructor: `type` argument has been removed
-* in `node` constructor: `type` argument has been removed
-* in `element` constructor:  `type` argument is replaced by `elem_dim` and the corresponding value must be the geometrical dimension of the element
+* change of `pre_lmgc` submodule name to `pre` (submodule of `pylmgc90`)
+* in `tact_behav` constructor, argument name `type` is replaced by `law`
+* in `model` constructor, argument name `type` is replaced by `physics`
+* in `material` constructor,  argument name`type` is replaced by `materialType`
+* in `avatar.addContactors` method, argument name `type` is replaced by `shape`
+* in `avatar.rotate` method, argument name `type` is replaced by `description`
+* in `avatar.imposeDrivenDof` method, argument name `type` is replaced by `description`
+* in `postpro_command' constructor, argument name `type` is replaced by `name`
+* in `buildMesh2D` function, argument name `type_mesh` is replaced by `mesh_type`
+* in `avatar` constructor, argument named `type` has been removed
+* in `node` constructor,  argument named `type` has been removed
+* in `element` constructor, argument named `type` is replaced by `elem_dim` and the corresponding value must be the geometrical dimension of the element