DOCS-493: edits

Author: Bob Grabar

source/core/replication-internals.txt

@@ -37,10 +37,11 @@ operations require idempotency:
 - post-rollback catch-up
 - sharding chunk migrations
 
-  .. TODO Verify that "sharding chunk migrations" (above) requires
-     idempotency. The wiki was unclear on the subject.
+.. seealso:: The :ref:`replica-set-oplog-sizing` topic in
+   :doc:`/core/replication`.
 
-For more information about the oplog, see :ref:`oplog sizing <replica-set-oplog-sizing>`.
+.. TODO Verify that "sharding chunk migrations" (above) requires
+   idempotency. The wiki was unclear on the subject.
 
 .. In 2.0, replicas would import entries from the member lowest
 .. "ping," This wasn't true in 1.8 and will likely change in 2.2.

source/core/replication.txt

@@ -21,9 +21,8 @@ replica sets as a more sophisticated form of traditional master-slave
 replication. [#master-slave]_ In master-slave replication, a
 :term:`master` node accepts writes while one or more :term:`slave`
 nodes replicate those write operations and thus maintain data sets
-identical to the master. In MongoDB deployments, the member that accepts write
-operations is the **primary**, and the replicating members are the
-**secondaries**.
+identical to the master. For MongoDB deployments, the member that accepts write
+operations is the **primary**, and the replicating members are **secondaries**.
 
 MongoDB's replica sets provide automated failover. If a
 :term:`primary` fails, the remaining members will automatically

source/replication.txt

@@ -2,33 +2,23 @@
 Replication
 ===========
 
-MongoDB supports database replication using a cluster of servers
-known as a replica set. A replica set provides master-slave-style
-replication with automated failover.
+Database replication ensures redundancy, backup, and automatic failover.
+Replication occurs through groups of servers known as replica sets.
 
-If you're just getting started with replication in MongoDB, check out
-the :doc:`core replication docs </core/replication>` and the docs on
-:doc:`using replica sets in the application development
-<applications/replication>`.
+This page lists the documents, tutorials, and reference pages that describe replica sets.
 
-There's also a very good `video introduction`_ to replica sets in
-MongoDB.
-
-Before deploying a replica set to production, you should be familiar
-with the :doc:`suggested replication architectures
-<administration/replication-architectures>`. The :doc:`replica set
-administration <administration/replica-sets>` document covers basic
-administrative tasks such as adding and removing nodes.
-
-Finally, administrators and other advanced users will want to read up
-on :doc:`replication internals <core/replication-internals>` and
-consider the :ref:`replication reference material <replication-reference>`
-
-.. _`video introduction`: http://www.10gen.com/presentations/mongosv-2011/a-mongodb-replication-primer-replica-sets-in-practice
+For an overview, see :doc:`/core/replication`. To work with members, see
+:doc:`administration/replica-sets`. To configure deployment
+architecture, see :doc:`administration/replication-architectures`. To
+modify read and write operations, see :doc:`applications/replication`.
+For common procedures, see the :ref:`tutorials list
+<replica-set-tutorials-list>`.
 
 Documentation
 -------------
 
+The following is the expanded outline of the main documentation:
+
 .. toctree::
    :maxdepth: 2
 
@@ -38,6 +28,8 @@ Documentation
    applications/replication
    core/replication-internals
 
+.. _replica-set-tutorials-list:
+
 Tutorials
 ---------
 
@@ -59,13 +51,11 @@ operations in detail.
 Reference
 ---------
 
-Finally, consider the replication reference material. The first is a
-reference to the replica set configuration object and process:
+The following describes the replica set configuration object:
 
 - :doc:`/reference/replica-configuration`
 
-The next two documents describe the output of the replication status
-commands:
+The following describe status commands:
 
 - :doc:`/reference/replica-status`
 - :doc:`/reference/replication-info`