[536995] Improve documentation about migration and saving popup text

Bug: 536995
Change-Id: I202141dec6b78f2e8a085021bc687aac40b27da5
Signed-off-by: Pierre Guilet <pierre.guilet@obeo.fr>

5 files changed, 8 insertions, 3 deletions

diff --git a/plugins/org.eclipse.sirius.common.ui/plugin.properties b/plugins/org.eclipse.sirius.common.ui/plugin.properties
index 920b9c4919..abd3c9c137 100644
--- a/plugins/org.eclipse.sirius.common.ui/plugin.properties
+++ b/plugins/org.eclipse.sirius.common.ui/plugin.properties
@@ -40,7 +40,7 @@ RenameDialog_askNewName_caseInsensitive = Enter new name (case insensitive):
 RenameDialog_askNewName_caseSensitive = Enter new name (case sensitive):
 RenameDialog_errorNameClash = New name must be different
 RenameDialog_title = Rename representation
-MigrationUIUtil_askToSaveChanges = {0} have been modified by automatic migration. Save changes?
+MigrationUIUtil_askToSaveChanges = {0} have been modified by Sirius automatic migration. Save changes?
 SWTUtil_askToSaveChanges = {0} have been modified. Save changes?
 SWTUtil_askToSaveChanges_openElseWhere = {0} have been modified, but are still open elsewhere with identical changes. Closing this will not lose those changes. Save changes now anyway?
 SWTUtil_saveDialog_title = Save
diff --git a/plugins/org.eclipse.sirius.doc/doc/Release_Notes.html b/plugins/org.eclipse.sirius.doc/doc/Release_Notes.html
index d3d8901d02..e4870f6fcb 100644
--- a/plugins/org.eclipse.sirius.doc/doc/Release_Notes.html
+++ b/plugins/org.eclipse.sirius.doc/doc/Release_Notes.html
@@ -91,7 +91,9 @@
 		<h2 id="sirius6.1.0">Changes in Sirius 6.1.0</h2>
 		<h3 id="UserVisibleChanges">User-Visible Changes</h3>
 		<ul>
-			<li><span class="label label-success">Added</span> A new preference has been added in the Sirius preference panel. It allows Sirius to ask the user if he wants to save session resources after an automatic migration. If the new preference is ticked, the pop-up will only appear for session opening caused by a direct action of the user (i.e. opening a diagram or unfolding the resources in the model explorer).</li>
+			<li><span class="label label-success">Added</span> A new preference has been added in the Sirius preference panel. It allows Sirius to ask the user if he wants to save session resources after an automatic migration. If the new preference is ticked, the pop-up will only appear for session opening caused by a direct action of the user (i.e. opening a diagram or unfolding the resources in the model explorer). You can refer to the 
+				<a href="user/general/Modeling%20Project.html#Migration">user documentation </a> for more details. 
+			</li>
 		</ul>
 		<h3 id="SpecifierVisibleChanges">Specifier-Visible Changes</h3>
 		<h3 id="DeveloperVisibleChanges">Developer-Visible Changes</h3>
diff --git a/plugins/org.eclipse.sirius.doc/doc/Release_Notes.textile b/plugins/org.eclipse.sirius.doc/doc/Release_Notes.textile
index 86634d41e5..17a7251574 100644
--- a/plugins/org.eclipse.sirius.doc/doc/Release_Notes.textile
+++ b/plugins/org.eclipse.sirius.doc/doc/Release_Notes.textile
@@ -8,7 +8,7 @@ h2(#sirius6.1.0). Changes in Sirius 6.1.0
 
 h3. User-Visible Changes
 
-* <span class="label label-success">Added</span> A new preference has been added in the Sirius preference panel. It allows Sirius to ask the user if he wants to save session resources after an automatic migration. If the new preference is ticked, the pop-up will only appear for session opening caused by a direct action of the user (i.e. opening a diagram or unfolding the resources in the model explorer).
+* <span class="label label-success">Added</span> A new preference has been added in the Sirius preference panel. It allows Sirius to ask the user if he wants to save session resources after an automatic migration. If the new preference is ticked, the pop-up will only appear for session opening caused by a direct action of the user (i.e. opening a diagram or unfolding the resources in the model explorer). You can refer to the "user documentation ":user/general/Modeling%20Project.html#Migration for more details. 
 
 h3. Specifier-Visible Changes
 
diff --git a/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.html b/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.html
index affbf9cff8..05aa45c8f7 100644
--- a/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.html
+++ b/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.html
@@ -169,6 +169,7 @@
 			</li>
 			<li>When you open your bundle whereas a Sirius editor was opened previously.</li>
 		</ul>
+		<p>The side effect of this operation is that your model will not be openable in previous version of the product. So you should backup your models if you still want to be able to open it in the previous version.</p>
 		<h3 id="UICHanges">User Interface Changes</h3>
 		<p>You will notice some radical changes in the user interface. The most important change is the disappearance of the 
 			<em>Model Content</em> view. It has been replaced with a streamlined UI which integrates directly into the Eclipse explorer view. The notion of &#8220;Local Session&#8221; has disappeared from the user interface; its management has been made as transparent as possible so you do not have to deal with it except in some very specific circumstances.
diff --git a/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.textile b/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.textile
index 444723f54b..ca91033282 100644
--- a/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.textile
+++ b/plugins/org.eclipse.sirius.doc/doc/user/general/Modeling Project.textile
@@ -42,6 +42,8 @@ When checked, a dialog asking you to save migrated resources is shown in the fol
 * When you open the session by double clicking on the aird or VSM or by using the contextual menu _open_.
 * When you open your bundle whereas a Sirius editor was opened previously.
 
+The side effect of this operation is that your model will not be openable in previous version of the product. So you should backup your models if you still want to be able to open it in the previous version.
+
 h3(#UICHanges). User Interface Changes
 
 You will notice some radical changes in the user interface. The most important change is the disappearance of the _Model Content_ view. It has been replaced with a streamlined UI which integrates directly into the Eclipse explorer view. The notion of "Local Session" has disappeared from the user interface; its management has been made as transparent as possible so you do not have to deal with it except in some very specific circumstances.