diff --git a/docs/static/persistent-queues.asciidoc b/docs/static/persistent-queues.asciidoc
index 55573312c..379bae63d 100644
--- a/docs/static/persistent-queues.asciidoc
+++ b/docs/static/persistent-queues.asciidoc
@@ -42,7 +42,9 @@ TIP: If you want to define values for a specific pipeline, use <<multiple-pipeli
 
 `queue.type`:: Specify `persisted` to enable persistent queues. By default, persistent queues are disabled (default: `queue.type: memory`).
 `path.queue`:: The directory path where the data files will be stored. By default, the files are stored in `path.data/queue`. 
-`queue.page_capacity`:: The maximum size of a queue page in bytes. The queue data consists of append-only files called "pages". The default size is 64mb. Changing this value is unlikely to have performance benefits.
+`queue.page_capacity`:: The queue data consists of append-only files called "pages." This value sets the maximum size of a queue page in bytes. 
+The default size of 64mb is a good value for most users, and changing this value is unlikely to have performance benefits. 
+If you change the page capacity of an existing queue, the new size applies only to the new page.
 `queue.drain`:: Specify `true` if you want Logstash to wait until the persistent queue is drained before shutting down. The amount of time it takes to drain the queue depends on the number of events that have accumulated in the queue. Therefore, you should avoid using this setting unless the queue, even when full, is relatively small and can be drained quickly. 
 `queue.max_events`:: The maximum number of events not yet read by the pipeline worker. The default is 0 (unlimited).
 We use this setting for internal testing. 
@@ -54,8 +56,10 @@ queue will be sized at the value of `queue.max_bytes` specified in
 The default is 1024mb (1gb).
 +
 Be sure that your disk has sufficient capacity to handle the cumulative total of `queue.max_bytes` across all persistent queues.
-The total of `queue.max.bytes` for _all_ queues should be
+The total of `queue.max_bytes` for _all_ queues should be
 lower than the capacity of your disk. 
+We do not check to see if the disk has enough capacity for `queue.max_bytes` for all queues. 
+The space check at startup only verifies that each queue has sufficient capacity to reach its `queue.max_bytes`.
 +
 TIP: If you are using persistent queues to protect against data loss, but don't
 require much buffering, you can set `queue.max_bytes` to a smaller value.