DOCS-1068: clarifying notes on commands that turn secondaries into recovering members.

Author: Sam Kleinman

source/reference/command/compact.txt

@@ -168,17 +168,18 @@ compact
        ``force:true`` above for information regarding compacting the
        primary.
 
-     .. warning:: If you run :dbcommand:`compact` on a secondary,
-        the secondary will enter a ``RECOVERING`` state to prevent
-        clients from sending read operations during compaction. Once
-        the compaction finishes the secondary will automatically
-        return to ``SECONDARY`` state.  See :data:`~replSetGetStatus.members.state`
-        for more information on states.
-
-        Refer to the "`partial script for automating step down
-        and compaction <https://github.com/mongodb/mongo-snippets/blob/master/js/compact-example.js>`_"
+     .. warning::
+
+        If you run :dbcommand:`compact` on a secondary, the secondary
+        will enter a ``RECOVERING`` state to prevent clients from
+        sending read operations during compaction. Once the operation
+        finishes the secondary will automatically return to
+        ``SECONDARY`` state.  See :data:`~replSetGetStatus.members.state`
+        for more information replica set member states. Refer to the
+        "`partial script for automating step down and compaction`_"
         for an example of this procedure.
 
+
    - :dbcommand:`compact` is a command issued to a :program:`mongod`.
      In a sharded environment, run :dbcommand:`compact` on each shard
      separately as a maintenance operation.
@@ -190,3 +191,7 @@ compact
      fragmentation.
 
    .. seealso:: :dbcommand:`repairDatabase`
+
+
+.. _`partial script for automating step down and compaction`:
+   https://github.com/mongodb/mongo-snippets/blob/master/js/compact-example.js

source/reference/command/touch.txt

@@ -40,3 +40,12 @@ touch
       :program:`mongod` stores in memory may displace other records
       data in memory and hinder performance. Use with caution in
       production systems.
+
+   .. warning::
+
+      If you run :dbcommand:`touch` on a secondary, the secondary will
+      enter a ``RECOVERING`` state to prevent clients from sending
+      read operations during compaction. Once the operation finishes
+      the secondary will automatically return to ``SECONDARY`` state.
+      See :data:`~replSetGetStatus.members.state` for more information
+      on replica set member states.