Revise the point about starting a clean sync
authorMatthew Setter <matthew@matthewsetter.com>
Fri, 10 Mar 2017 07:35:55 +0000 (08:35 +0100)
committerMatthew Setter <matthew@matthewsetter.com>
Fri, 10 Mar 2017 07:35:55 +0000 (08:35 +0100)
On review, after feedback from @phil-davis, he's right that users need
to be fully briefed as to the implications of choosing a clean sync —
especially when they have a large amount of data in their account.

doc/faq.rst

index edbd1ff31055409e6d2324dfd2fe65d1c5b13b70..1b636d38e0aa42531a53122a7f693896d2aa7269 100644 (file)
@@ -45,5 +45,10 @@ image:: images/setup/ownCloud-replacement_connection_wizard.png
 This opens the ownCloud Connection Wizard, which you can see above, *but* with an extra option.
 This option provides the ability to either: keep the existing data (synced by the previous connection) or to start a clean sync (erasing the existing data).
 
+.. important:: 
+
+  Be careful before choosing the "Start a clean sync" option. The old sync folder *may* contain a considerable amount of data, ranging into the gigabytes or terabytes. If it does, after the client creates the new connection, it will have to download **all** of that information again. Instead, first move or copy the old local sync folder, containing a copy of the existing files, to the new location. Then, when creating the new connection choose "*keep existing data*" instead. The ownCloud client will check the files in the newly-added sync folder and find that they match what is on the server and not need to download anything. 
+
 Make your choice and click "**Connect...**".
 This will then step you through the Connection Wizard, just as you did when you setup the previous sync connection, but giving you the opportunity to choose a new sync directory.
+