DOCS-4525 text index sort order

Author: kay-kim

source/core/index-text.txt

@@ -83,6 +83,17 @@ Text Search and Hints
 
 .. include:: /includes/fact-hint-text-query-restriction.rst
 
+.. _text-index-and-sort:
+
+Text Index and Sort
+~~~~~~~~~~~~~~~~~~~
+
+Sort operations cannot obtain sort order from a ``text`` index, even
+from a :ref:`compound text index <text-index-compound>`; i.e. sort
+operations cannot use the ordering in the text index.
+
+.. _text-index-compound:
+
 Compound Index
 ~~~~~~~~~~~~~~
 
@@ -92,7 +103,10 @@ these compound indexes have the following restrictions:
 
 .. include:: /includes/fact-compound-index-with-text-restrictions.rst
 
-See :doc:`/tutorial/limit-number-of-items-scanned-for-text-search`.
+See also :ref:`text-index-and-sort` for additional limitations.
+
+For an example of a compound text index, see
+:doc:`/tutorial/limit-number-of-items-scanned-for-text-search`.
 
 .. _text-index-storage-requirements:
 

source/includes/fact-compound-index-with-text-restrictions.rst

@@ -1,7 +1,8 @@
-A compound ``text`` index cannot include any other special index types,
-such as :ref:`multi-key <index-type-multi-key>` or :ref:`geospatial
-<index-feature-geospatial>` index fields.
+- A compound ``text`` index cannot include any other special index
+  types, such as :ref:`multi-key <index-type-multi-key>` or
+  :ref:`geospatial <index-feature-geospatial>` index fields.
 
-If the compound ``text`` index includes keys **preceding** the ``text``
-index key, to perform a :query:`$text` search, the query predicate must
-include **equality match conditions** on the preceding keys.
+- If the compound ``text`` index includes keys **preceding** the
+  ``text`` index key, to perform a :query:`$text` search, the query
+  predicate must include **equality match conditions** on the preceding
+  keys.

source/tutorial/limit-number-of-items-scanned-for-text-search.txt

@@ -48,6 +48,8 @@ query scans only those documents with ``dept`` equal to ``kitchen``:
 
    db.inventory.find( { dept: "kitchen", $text: { $search: "green" } } )
 
-.. include:: /includes/fact-compound-index-with-text-restrictions.rst
+.. note::
+
+   .. include:: /includes/fact-compound-index-with-text-restrictions.rst
 
 .. seealso:: :doc:`/core/index-text`