DOCS-408: edits

Author: Sam Kleinman

draft/tutorial/convert-secondary-into-arbiter.txt

@@ -4,23 +4,26 @@ Convert a Secondary to an Arbiter
 
 .. default-domain:: mongodb
 
-You can convert a secondary member to an arbiter either by shutting down
-the secondary and restarting it as an arbiter, or by starting the
-arbiter on a new port and then shutting down the instance of the
-secondary. This document describes both procedures.
+If you have a :term:`secondary` in a :term:`replica set` that no
+longer needs to hold a copy of the data *but* that you want to retain
+in the set to ensure that the replica set will be able to :ref:`elect
+a primary <replica-set-elections>`, you can convert the secondary into
+an :ref:`arbiter <replica-set-arbiters>`. This document provides two
+equivalent procedures for this process.
 
 Synopsis
 --------
 
-To convert a secondary to an arbiter you have two options:
+Both of the following procedures are operationally equivalent. Choose
+whichever procedure you are most comfortable with:
 
-#. Run the arbiter on the same port number as you ran the secondary.
-   In this option, you must shut down the secondary and remove its data
+#. You may operate the arbiter on the same port as the former secondary.
+   In this procedure, you must shut down the secondary and remove its data
    before restarting and reconfiguring it as an arbiter.
 
    For this procedure, see :ref:`replica-set-convert-secondary-to-arbiter-same-port`.
 
-#. Run the arbiter on a new port number. In this option, you can
+#. Run the arbiter on a new port. In this procedure, you can
    reconfigure the server as an arbiter before shutting down the
    instance running as a secondary.
 
@@ -29,8 +32,8 @@ To convert a secondary to an arbiter you have two options:
 .. seealso::
 
    - :ref:`replica-set-arbiters`
-   - :ref:`replica-set-arbiter-nodes`
    - :method:`rs.addArb()`
+   - :doc:`/administration/replica-sets`
 
 Procedures
 ----------
@@ -41,7 +44,7 @@ Convert a Secondary to an Arbiter and Reuse the Port Number
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 #. Remove the :term:`secondary` from the :term:`replica set` by calling
-   the :method:`rs.remove()` method while connected to the current
+   the :method:`rs.remove()` method. Perform this operation while connected to the current
    :term:`primary` in the :program:`mongo` shell:
 
    .. code-block:: javascript
@@ -116,13 +119,13 @@ Convert a Secondary to an Arbiter Running on a New Port Number
 
       mkdir /data/db-temp
 
-#. Start a new :program:`mongod` instance on a different port from the
-   secondary, specifying the new data directory and the existing replica
+#. Start a new :program:`mongod` instance on a different port,
+   specifying the new data directory and the existing replica
    set. Issue a command similar to the following:
 
    .. code-block:: sh
 
-      mongod --port 27021 --dbpath /data/db --replSet rs
+      mongod --port 27021 --dbpath /data/db-temp --replSet rs
 
 #. In the :program:`mongo` shell connected to the current primary,
    convert the secondary to an arbiter using the :method:`rs.addArb()`
@@ -170,4 +173,4 @@ Convert a Secondary to an Arbiter Running on a New Port Number
 
       mv /data/db /data/db-old
 
-   .. optional:: You may remove the data instead.
+   .. optional:: You may remove the data instead.