DOCSP-33515-shard-key-updates (#5886) (#5958)

* DOCSP-33515-shard-key-updates

* DOCSP-33515-shard-key-updates

* DOCSP-33515-shard-key-updates

* DOCSP-33515-shard-key-updates

* DOCSP-33515-shard-key-updates

* DOCSP-33515-shard-key-updates

* DOCSP-33515-shard-key-updates

* DOCSP-33515-shard-key-updates

---------

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/includes/analyzeShardKey-supporting-indexes.rst

@@ -34,3 +34,6 @@ index requirements:
 - Index is not :ref:`multi-key <index-type-multikey>`
 - Index is not :ref:`sparse <index-type-sparse>`
 - Index is not :ref:`partial <index-type-partial>`
+
+To create supporting indexes, use the
+:method:`db.collection.createIndex()` method.

source/includes/cqa-queryAnalysisSampleExpirationSecs.rst

@@ -2,8 +2,7 @@ queryAnalysisSampleExpirationSecs
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Sampled queries are stored in an internal collection that has a TTL
-index with ``expireAfterSeconds``. Configure ``expireAfterSeconds``
-with the ``queryAnalysisSampleExpirationSecs`` server parameter.
-with the :parameter:`queryAnalysisSampleExpirationSecs`.
+index with ``expireAfterSeconds``. To configure ``expireAfterSeconds``,
+use the :parameter:`queryAnalysisSampleExpirationSecs` server parameter.
 Sampled queries are automatically deleted after
 ``queryAnalysisSampleExpirationSecs``.

source/reference/command/analyzeShardKey.txt

@@ -101,7 +101,7 @@ Limitations
 Access Control
 --------------
 
-|analyzeShardKey| requires one of the following roles:
+|analyzeShardKey| requires one of these roles:
 
 - :authaction:`enableSharding` privilege action against the collection 
   being analyzed.
@@ -145,6 +145,14 @@ Examples
 
 .. include:: /includes/analyzeShardKey-example-intro.rst
 
+.. note::
+
+   Before you run ``analyzeShardKey`` commands, read the
+   :ref:`supporting-indexes-ref` section earlier on this page. If you
+   require supporting indexes for the shard key you are analyzing, use
+   the :method:`db.collection.createIndex()` method to create the
+   indexes.
+
 { lastName: 1 } keyCharacteristics
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~