another one

Author: ksuarz

source/includes/steps-change-replica-set-wiredtiger.yaml

@@ -39,9 +39,10 @@ post: |
 
   .. include:: /includes/fact-storage-engine-configuration-file-setting.rst
 ---
-title: "Repeat the procedure for each replica set member."
+title: "Repeat the procedure for other replica set secondaries you wish to upgrade."
 ref: change-wt-repl-sync-repeat
 pre: |
-  Perform this procedure again for the rest of the secondary members of the
-  replica set you wish to use the WiredTiger storage engine.
+  Perform this procedure again for the rest of the :term:`secondary
+  members <secondary>` of the replica set you wish to use the WiredTiger
+  storage engine.
 ...

source/tutorial/change-config-server-wiredtiger.txt

@@ -14,6 +14,9 @@ This tutorial gives an overview of changing the storage engine of the
 :term:`config servers <config server>` in a :term:`sharded cluster` to
 :ref:`WiredTiger <storage-wiredtiger>`.
 
+Considerations
+--------------
+
 .. include:: /includes/fact-config-server-storage-engine-mix.rst
 
 .. include:: /includes/fact-wiredtiger-minimum-version.rst

source/tutorial/change-replica-set-wiredtiger.txt

@@ -11,19 +11,22 @@ Change Replica Set to WiredTiger
 .. versionchanged:: 3.2
    WiredTiger is the new default storage engine for MongoDB.
 
-This tutorial gives an overview of changing the storage engine of the
+This tutorial gives an overview of changing the storage engine of a
 member of a :term:`replica set` to :ref:`WiredTiger
-<storage-wiredtiger>`. Replica sets can have members with different
-storage engines. As such, you can update members to use the WiredTiger
-storage engine in a rolling fashion. Before changing all the members to
-use WiredTiger, you may prefer to run with mixed storage engines for
-some period. However, performance can vary according to workload.
+<storage-wiredtiger>`.
 
-.. include:: /includes/fact-wiredtiger-minimum-version.rst
+Considerations
+--------------
+
+Replica sets can have members with different storage engines. As such,
+you can update members to use the WiredTiger storage engine in a rolling
+fashion. Before changing all the members to use WiredTiger, you may
+prefer to run with mixed storage engines for some period. However,
+performance can vary according to workload.
 
-.. important::
+.. include:: /includes/fact-wiredtiger-minimum-version.rst
 
-   .. include:: /includes/2.6-3.0-mixed-version-wiredTiger-restriction.rst
+.. include:: /includes/2.6-3.0-mixed-version-wiredTiger-restriction.rst
 
 Procedure
 ---------
@@ -32,7 +35,8 @@ This procedure completely removes a :term:`secondary` replica set
 member's data, starts :program:`mongod` with WiredTiger, and performs an
 :doc:`initial sync </tutorial/resync-replica-set-member>`.
 
-If you want to upgrade the primary to use the WiredTiger storage engine,
-first step down the primary with :method:`rs.stepDown()`.
+To update all members of the replica set to use WiredTiger, update the
+:term:`secondary` members first. Then step down the :term:`primary`, and
+update the stepped-down member.
 
 .. include:: /includes/steps/change-replica-set-wiredtiger.rst

source/tutorial/change-sharded-cluster-wiredtiger.txt

@@ -14,10 +14,7 @@ Change Sharded Cluster to WiredTiger
 
 This tutorial gives an overview of changing the storage engines of a
 component of a :term:`sharded cluster` to :ref:`WiredTiger
-<storage-wiredtiger>`. Note that a sharded cluster **can** have mixed
-storage engines for its individual :term:`shards <shard>`.
-
-.. include:: /includes/fact-wiredtiger-minimum-version.rst
+<storage-wiredtiger>`.
 
 Considerations
 --------------
@@ -26,17 +23,18 @@ This procedure may involve downtime, especially if one or more of your
 shards is a :term:`standalone`. If you change the host or port of any
 :term:`shard`, you must update the shard configuration as well.
 
-.. important::
-
-   .. include:: /includes/2.6-3.0-mixed-version-wiredTiger-restriction.rst
-
-.. include:: /includes/fact-config-server-storage-engine-mix.rst
+.. include:: /includes/fact-wiredtiger-minimum-version.rst
 
-.. seealso:: :doc:`/tutorial/change-config-server-wiredtiger`
+.. include:: /includes/2.6-3.0-mixed-version-wiredTiger-restriction.rst
 
 Change Shards to WiredTiger
 ---------------------------
 
+.. note::
+
+   A sharded cluster **can** have mixed storage engines for its
+   individual :term:`shards <shard>`.
+
 To change the storage engine for the :term:`shards <shard>` to
 WiredTiger, refer to the appropriate procedure for each shard:
 
@@ -46,6 +44,17 @@ WiredTiger, refer to the appropriate procedure for each shard:
 - If the shard is a :term:`replica set`, see
   :doc:`/tutorial/change-replica-set-wiredtiger`.
 
+Change Config Servers to WiredTiger
+-----------------------------------
+
+To change the storage engines of the :term:`config servers <config
+server>` of a sharded cluster, see
+:doc:`/tutorial/change-config-server-wiredtiger`.
+
+.. include:: /includes/fact-config-server-storage-engine-mix.rst
+
+.. seealso:: :doc:`/tutorial/change-config-server-wiredtiger`
+
 .. class:: hidden
 
    .. toctree::

source/tutorial/change-standalone-wiredtiger.txt

@@ -12,18 +12,19 @@ Change Standalone to WiredTiger
 
 This tutorial gives an overview of changing the storage engine of a
 :term:`standalone` MongoDB instance to :ref:`WiredTiger
-<storage-wiredtiger>`. It uses the :program:`mongodump` and
-:program:`mongorestore` utilities to export and import data. Ensure that
-these MongoDB package components are installed and updated on your
-system.
+<storage-wiredtiger>`.
 
-.. include:: /includes/fact-wiredtiger-minimum-version.rst
+Considerations
+--------------
 
-.. note::
+This tutorial uses the :program:`mongodump` and :program:`mongorestore`
+utilities to export and import data. Ensure that these MongoDB package
+components are installed and updated on your system. In addition, make
+sure you have sufficient drive space available for the
+:program:`mongodump` export file and the data files of your new
+:program:`mongod` instance running with WiredTiger.
 
-   Make sure you have sufficient drive space available for the
-   :program:`mongodump` export file and the data files of your new
-   :program:`mongod` instance running with WiredTiger.
+.. include:: /includes/fact-wiredtiger-minimum-version.rst
 
 Procedure
 ---------