DOCS-6621 : Move $natural to cursor.hint()

config/redirects.yaml

@@ -960,4 +960,11 @@ type: 'redirect'
 code: 303
 outputs:
   - 'before-v3.0'
+---
+from : '/reference/operator/query-modifier'
+to: '/reference/method/js-cursor'
+type: 'redirect'
+code: 303
+outputs:
+  - 'after-v3.0'
 ...

source/includes/apiargs-method-cursor.hint-param.yaml

@@ -3,6 +3,11 @@ description: |
   The index to "hint" or force MongoDB to use when performing the query.
   Specify the index either by the index name or by the index
   specification document.
+
+  You can also specify ``{ $natural : 1 }`` to force the query to perform a 
+  forwards collection scan, or ``{ $natural : -1 }`` for a reverse 
+  collection scan.
+
 interface: method
 name: index
 operation: cursor.hint

source/includes/toc-operator-landing.yaml

@@ -12,8 +12,4 @@ file: /reference/operator/aggregation
 description: |
   Aggregation pipeline operations have a collection of operators
   available to define and manipulate documents in pipeline stages.
----
-file: /reference/operator/query-modifier
-description: |
-  Query modifiers determine the way that queries will be executed.
 ...

source/reference/method/cursor.hint.txt

@@ -41,6 +41,20 @@ You can also specify the index using the index name:
 .. code-block:: javascript
 
    db.users.find().hint( "age_1" )
+
+You can specify ``{ $natural : 1 }`` to force the query to perform a forwards
+collection scan:
+
+.. code-block:: javascript
+
+   db.users.find().hint( { $natural : 1 } )
+
+You can also specify ``{ $natural : -1 }`` to force the query to perform a 
+reverse collection scan:
+
+.. code-block:: javascript
+
+   db.users.find().hint( { $natural : -1 } )
 
 .. seealso::
 

source/reference/method/js-cursor.txt

@@ -4,6 +4,8 @@ Cursor Methods
 
 .. default-domain:: mongodb
 
+These methods modify the way that the underlying query is executed.
+
 .. include:: /includes/toc/table-method-cursor.rst
 
 .. include:: /includes/toc/method-cursor.rst

source/reference/operator/meta/natural.txt

@@ -9,45 +9,8 @@ $natural
 Definition
 ----------
 
-.. operator:: $natural
-
-  Use the :operator:`$natural` operator to use :term:`natural order` for
-  the results of a sort operation. Natural order refers to the logical
-  :ref:`ordering <return-natural-order>` of documents internally within the
-  database.
-
-  The :operator:`$natural` operator uses the following syntax to return
-  documents in the order they exist on disk:
-
-  .. code-block:: javascript
-
-     db.collection.find().sort( { $natural: 1 } )
-
-Behavior
---------
-
-On a sharded collection the :operator:`$natural` operator returns a
-collection scan sorted in :ref:`natural order <return-natural-order>`, the
-order the database inserts and stores documents on disk.
-
-.. include:: /includes/fact-natural-parameter.rst
+.. versionchanged:: 3.2
 
-.. include:: /includes/fact-natural-sort-order-text-query-restriction.rst
-
-Examples
---------
-
-Reverse Order
-~~~~~~~~~~~~~
-
-Use ``{ $natural: -1 }`` to return documents in the reverse order as
-they occur on disk:
-
-.. code-block:: javascript
-
-   db.collection.find().sort( { $natural: -1 } )
-
-Additional Information
-----------------------
+.. operator:: $natural
 
-:method:`cursor.sort()`
+  See :method:`cursor.hint()` for :operator:`$natural` usage.

source/reference/operator/query-modifier.txt

@@ -4,23 +4,6 @@ Query Modifiers
 
 .. default-domain:: mongodb
 
-Introduction
-------------
-
 MongoDB provides :doc:`cursor methods </reference/method/js-cursor>` for 
-setting options on a query.
-
-Operators
----------
-
-Modifiers
-~~~~~~~~~
-
-See :doc:`/reference/method/js-cursor` for query modifiers.
-
-Sort Order
-~~~~~~~~~~
-
-.. include:: /includes/toc/table-operator-sort-order.rst
+setting options or modifiers on a query.
 
-.. include:: /includes/toc/operator-sort-order.rst