Update documentation

Author: rubenmromero

README.md

@@ -36,9 +36,8 @@ Being positioned at the branch you want to update, you can directly run the `./b
 
 * Updates the active local branch (`git pull`) and submodules status (`git submodule init` & `git submodule update`).
 * Updates all environment branches of each submodule.
-* If the active branch is the first environment branch (the branch defined in the first position), the script directly does the following actions:
- * Positions each submodule in the last commit (HEAD) of its first environment branch.
- * Commits the produced changes by the previous action, in the event that there are, including as commit message the list of updates done by the script.
-* If the active branch is any other different from the first, there are the following execution alternatives:
- * If the script has been executed with the `[-k|--keep]` optional parameter,it directly perfoms the following actions:
- * Merges the previous environment branch in order to propagate the commited and pushed changes made in the previous environment/s of the project.
+* If the active branch is the first environment branch (the branch defined in the first position), the script directly positions each submodule in the last commit (HEAD) of its first environment branch.
+* If the active branch is any other different from the first, the script merges the previous environment branch in order to propagate the commited and pushed changes made in the previous environment/s of the project, and then perfoms the following execution alternatives:
+ * If the script has been executed with the `[-k|--keep]` optional parameter, it keeps for each submodule the current commit versioned in the active branch, discarding the new submodules versions (commits) that may have been updated due to the merge process.
+ * If the script has been executed without any parameter, it shows for each submodule the current commit versioned in the active branch, and interactively asks to select the environment branch in which you want to position the submodule, offering an additional option to keep the current commit.
+* Commits the changes made by the previous action, in the event that there are, including as commit message the list of updates made by the script.