Document ignoreDelete

advanced/folder-ignoredelete.rst

@@ -0,0 +1,28 @@
+ignoreDelete
+============
+
+``ignoreDelete`` is an advanced folder setting that affects the handling of
+incoming index updates. When set, incoming updates with the delete flag set
+are ignored.
+
+Example Scenario
+----------------
+
+Assume two devices, "Alice" and "Bob", sharing a folder. Bob has set
+``ignoreDelete``.
+
+New and updated files are synchronized as usual between Alice and Bob. When
+Bob deletes a file, it is deleted for Alice as well. When Alice deletes a
+file, Bob ignores that update and does not delete the file.
+
+In this state, Bob is fully up to date from his own point of view, as is Alice
+from her own point of view. However from the point of view of Bob, who ignored
+the delete entry from Alice, Alice is now out of date because she is missing
+the file that was deleted.
+
+Should Bob modify any of the files that Alice has deleted, the update will be
+sent to Alice and Alice will download the now updated file.
+
+.. note::
+	 Ignoring deletes in both directions between two devices can be a
+	 confusing configuration.

users/advanced.rst

@@ -0,0 +1,25 @@
+.. _advanced:
+
+Advanced Configuration
+======================
+
+Description
+-----------
+
+Syncthing has settings that are available but not exposed in the usual folder
+and device configuration screens. The reason for not exposing these settings
+more prominently varies from them simply being rarely useful, to them being
+actively dangerous when used improperly.
+
+.. warning::
+   Use care when changing advanced configuration settings and make sure that
+   you understand the resulting effects and consequences.
+
+Per Folder Settings
+-------------------
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   ../advanced/folder-*