@@ -19,8 +19,9 @@
      a1   2   3
 
 * added new boolean argument 'overwrite' to Session.save, Session.to_hdf, Session.to_excel and Session.to_pickle
-  methods (closes issue:`293`). If overwrite=True, the file is removed and replaced by a new one if it already existed.
-  This is the default behavior. If overwrite=False, its content is updated :
+  methods (closes issue:`293`). If overwrite=True and the target file already existed, it is deleted and replaced by a
+  new one. This is the new default behavior. If overwrite=False, an existing file is updated (like it was in previous
+  larray versions):
 
     >>> arr1, arr2, arr3 = ndtest((2, 2)), ndtest(4), ndtest((3, 2))
     >>> s = Session([('arr1', arr1), ('arr2', arr2), ('arr3', arr3)])
@@ -59,7 +60,7 @@ Miscellaneous improvements
     >>> wb = open_excel()
     >>> wb['Sh<tab>  # will be completed to `wb['Sheet1`
 
-* added documentation to methods of Session class (closes :issue:`277`)
+* added documentation for Session methods (closes :issue:`277`).
 
 * allowed to provide explict names for arrays or sessions in compare(). Closes :issue:`307`.
 
@@ -69,9 +70,9 @@ Fixes
 
 * fixed title argument of `ndtest` creation function: title was not passed to the returned array.
 
-* fixed create_sequential when arguments initial and inc are array and scalar respectively (closes issue:`288`)
+* fixed create_sequential when arguments initial and inc are array and scalar respectively (closes issue:`288`).
 
-* fixed autocompletion of attributes of LArray and Group objects (closes issue:`302`)
+* fixed auto-completion of attributes of LArray and Group objects (closes issue:`302`).
 
 * fixed name of arrays/sessions in compare() not being inferred correctly (closes :issue:`306`).
 
@@ -84,10 +85,10 @@ Fixes
 
 * fixed some warning messages to point to the correct line in user code.
 
-* fixed crash of Session.save method when it contains a 0D array.
-  0D arrays are now skipped when saving a session (closes issue:`291`).
+* fixed crash of Session.save method when it contained 0D arrays. They are now skipped when saving a session (closes
+  issue:`291`).
 
-* fixed Session.save and Session.to_excel failing to create new Excel file
-  (it only worked if the file already existed). Closes issue:`313`.
+* fixed Session.save and Session.to_excel failing to create new Excel files (it only worked if the file already
+  existed). Closes issue:`313`.
 
 * fixed Session.load(file, engine='pandas_excel') : axes were considered as anonymous.