diff --git a/documentation/src/main/asciidoc/topics/code_examples/SingleFileStore.java b/documentation/src/main/asciidoc/topics/code_examples/SingleFileStore.java
index 5df98fafb452..a29f8c57a14f 100644
--- a/documentation/src/main/asciidoc/topics/code_examples/SingleFileStore.java
+++ b/documentation/src/main/asciidoc/topics/code_examples/SingleFileStore.java
@@ -6,7 +6,7 @@
          .shared(false)
          .fetchPersistentState(true)
          .ignoreModifications(false)
-         .purgeOnStartup(false)
+         .purgeOnStartup(true)
          .location(System.getProperty("java.io.tmpdir"))
          .async()
             .enabled(true)
diff --git a/documentation/src/main/asciidoc/topics/config_examples/file_store.xml b/documentation/src/main/asciidoc/topics/config_examples/file_store.xml
index 0e1c2b2cc0d2..5200cd82f03e 100644
--- a/documentation/src/main/asciidoc/topics/config_examples/file_store.xml
+++ b/documentation/src/main/asciidoc/topics/config_examples/file_store.xml
@@ -4,7 +4,7 @@
            shared="false" preload="true"
            fetch-state="true"
            read-only="false"
-           purge="false"
+           purge="true"
            path="${java.io.tmpdir}">
       <write-behind modification-queue-size="123" />
    </file-store>
diff --git a/documentation/src/main/asciidoc/topics/proc_configuring_cache_stores.adoc b/documentation/src/main/asciidoc/topics/proc_configuring_cache_stores.adoc
index e5cd7fc76cc3..824f03d4be1e 100644
--- a/documentation/src/main/asciidoc/topics/proc_configuring_cache_stores.adoc
+++ b/documentation/src/main/asciidoc/topics/proc_configuring_cache_stores.adoc
@@ -9,29 +9,39 @@ only.
 .Procedure
 
 . Use the `persistence` parameter to configure the persistence layer for caches.
-. Add {brandname} cache stores with the appropriate configuration, as in the
-following examples:
+. Configure whether cache stores are local to the node or shared across the cluster.
++
+Use either the `shared` attribute declaratively or the `shared(false)` method programmatically.
++
+. Configure other cache stores properties as appropriate. Custom cache stores can also include `property` parameters.
++
+[NOTE]
+====
+Configuring cache stores as shared or not shared (local only) determines which
+parameters you should set. In some cases, using the wrong combination of
+parameters in your cache store configuration can lead to data loss or
+performance issues.
+
+For example, if the cache store is local to a node then it makes sense to fetch
+state and purge on startup. However, if the cache store is shared, then you
+should not fetch state or purge on startup.
+====
 
-.Declarative configuration for a file-based cache store
+.Local (non-shared) file store
 
 [source,xml,options="nowrap",subs=attributes+]
 ----
 include::config_examples/file_store.xml[]
 ----
 
-.Declarative configuration for a custom cache store configuration
+.Shared custom cache store
 
 [source,xml,options="nowrap",subs=attributes+]
 ----
 include::config_examples/custom_cache_store.xml[]
 ----
 
-[NOTE]
-====
-Custom cache stores include `property` parameters that let you configure specific attributes for your cache store.
-====
-
-.Programmatic configuration for a single file cache store
+.Single file store
 
 [source,java]
 ----