DOCSP-24963 BACKPORT (#1769)

Author: Dave Cuthbert

source/core/sharding-find-shard-key.txt

@@ -12,12 +12,18 @@ Find a Shard Key
    :depth: 2
    :class: singlecol
 
-To find the shard key of an existing sharded collection, use the
-:method:`db.printShardingStatus()` method:
+Every shared collection has a :ref:`shard key <sharding-shard-key>`. To
+display the shard key, connect to a :binary:`mongos` instance and run
+the :method:`db.printShardingStatus()` method:
 
 .. code-block:: javascript
 
    db.printShardingStatus()
 
-For details on the :method:`db.printShardingStatus()` output, see
-:method:`sh.status()`.
+The output resembles:
+
+.. include:: /includes/reference/sharded-status-output.rst
+
+For more details on the ``db.printShardingStatus()`` output, see the
+:ref:`sharded collection section <sharded-collection-output-reference>`
+on the :method:`sh.status()` page.

source/includes/reference/sharded-status-output.rst

@@ -0,0 +1,17 @@
+
+.. code-block:: javascript
+
+   <dbname>.<collection>
+      shard key: { <shard key> : <1 or hashed> }
+      unique: <boolean>
+      balancing: <boolean>
+      chunks:
+         <shard name1> <number of chunks>
+         <shard name2> <number of chunks>
+         ...
+      { <shard key>: <min range1> } -->> { <shard key> : <max range1> } on : <shard name> <last modified timestamp>
+      { <shard key>: <min range2> } -->> { <shard key> : <max range2> } on : <shard name> <last modified timestamp>
+      ...
+      tag: <tag1>  { <shard key> : <min range1> } -->> { <shard key> : <max range1> }
+      ...
+

source/reference/method/sh.status.txt

@@ -151,28 +151,16 @@ shard` for the database.
       { "_id" : <dbname2>, "primary" : <string>, "partitioned" : <boolean>, "version": <document> }
       ...
 
+.. _sharded-collection-output-reference:
+
 The :ref:`sharding-status-collection-fields` section provides
 information on the sharding details for sharded collection(s). For each
 sharded collection, the section displays the shard key, the number of
 chunks per shard(s), the distribution of chunks across shards
 [#chunk-details]_, and the tag information, if any, for shard key
 range(s).
 
-.. code-block:: javascript
-
-   <dbname>.<collection>
-      shard key: { <shard key> : <1 or hashed> }
-      unique: <boolean>
-      balancing: <boolean>
-      chunks:
-         <shard name1> <number of chunks>
-         <shard name2> <number of chunks>
-         ...
-      { <shard key>: <min range1> } -->> { <shard key> : <max range1> } on : <shard name> <last modified timestamp>
-      { <shard key>: <min range2> } -->> { <shard key> : <max range2> } on : <shard name> <last modified timestamp>
-      ...
-      tag: <tag1>  { <shard key> : <min range1> } -->> { <shard key> : <max range1> }
-      ...
+.. include:: /includes/reference/sharded-status-output.rst
 
 Output Fields
 -------------