merge: DOCS-865

Author: Sam Kleinman

source/reference/command/addShard.txt

@@ -20,7 +20,7 @@ addShard
 
    Use the :dbcommand:`addShard` command to add a database instance
    or replica set to a :term:`sharded cluster`.
-   You must run this command against a :program:`mongos` instance.
+   You must run this command when connected a :program:`mongos` instance.
 
    The command takes the following form:
 
@@ -47,8 +47,9 @@ addShard
    :term:`replica sets <replica set>`.
    To add a shard on a replica set you must specify the name of the
    replica set and the hostname of at least one member of the replica
-   set.  You may specify all of the hostnames, but at least one member
-   must be specified.
+   set. You must specify at least one member of the set, but can
+   specify all members in the set or another subset if
+   desired. :dbcommand:`addShard` takes the following form:
 
    .. code-block:: javascript
 
@@ -58,7 +59,7 @@ addShard
 
       .. code-block:: javascript
 
-         db.runCommand({ addShard: "repl0/mongodb3.example.net:27327"})
+         db.runCommand( { addShard: "repl0/mongodb3.example.net:27327"} )
 
    If you specify additional hostnames, all must be members of the same
    replica set.
@@ -78,7 +79,7 @@ addShard
 
    .. seealso::
 
-      * :method:`sh.addShard()`
-      * :doc:`/administration/sharding`
-      * :doc:`/tutorial/add-shards-to-shard-cluster`
-      * :doc:`/tutorial/remove-shards-from-cluster`
+      - :method:`sh.addShard()`
+      - :doc:`/administration/sharding`
+      - :doc:`/tutorial/add-shards-to-shard-cluster`
+      - :doc:`/tutorial/remove-shards-from-cluster`

source/reference/method/db.printShardingStatus.txt

@@ -9,7 +9,8 @@ db.printShardingStatus()
    Provides a formatted report of the sharding configuration and the
    information regarding existing chunks in a :term:`sharded cluster`.
 
-   This method must be executed on a :program:`mongos` instance.
+   Only use :method:`db.printShardingStatus()` when connected to a
+   :program:`mongos` instance.
 
    This method is a wrapper around the :dbcommand:`printShardingStatus`
    command.

source/reference/method/sh.addShard.txt

@@ -32,11 +32,12 @@ sh.addShard()
    :term:`replica sets <replica set>`.
    To add a shard on a replica set you must specify the name of the
    replica set and the hostname of at least one member of the replica
-   set.  You may specify all of the hostnames, but at least one member
-   must be specified.
+   set. You must specify at least one member of the set, but can
+   specify all members in the set or another subset if
+   desired. :method:`sh.addShard()` takes the following form:
 
-   If you specify additional hostnames, all must be members of the same
-   replica set.
+   If you specify additional hostnames, all must be members of the
+   same replica set.
 
    .. code-block:: javascript
 
@@ -55,8 +56,7 @@ sh.addShard()
 
    .. seealso::
 
-      * :dbcommand:`addShard`
-      * :doc:`/administration/sharding`
-      * :doc:`/tutorial/add-shards-to-shard-cluster`
-      * :doc:`/tutorial/remove-shards-from-cluster`
-
+      - :dbcommand:`addShard`
+      - :doc:`/administration/sharding`
+      - :doc:`/tutorial/add-shards-to-shard-cluster`
+      - :doc:`/tutorial/remove-shards-from-cluster`