DOCSP-47211-default-sort-order-setting (#724)

* DOCSP-47211-default-sort-order-setting

* DOCSP-47211-default-sort-order-setting

* DOCSP-47211-default-sort-order-setting

* DOCSP-47211-default-sort-order-setting

* DOCSP-47211-default-sort-order-setting

* DOCSP-47211 copy edits

* DOCSP-47211 t3ech edit

* DOCSP-47211 tech edit

* DOCSP-47211 tech edit

Author: ltran-mdb2

source/query/sort.txt

@@ -16,6 +16,12 @@ Sort the Returned Documents
 If the query bar displays the :guilabel:`Sort` option, you can specify
 the sort order of the returned documents.
 
+.. note::
+
+   If you specify a sort order in the Query Bar, the specified sort order
+   overrides the :ref:`default sort order <compass-sort-query-bar>` you set
+   in :guilabel:`Settings`. 
+
 .. BEGIN-COMPASS-ONLY
 
 Compatibility

source/settings.txt

@@ -67,6 +67,7 @@ Learn more
    Command Line Options </settings/command-line-options>
    Configuration File Settings </settings/config-file>
    Block Outgoing Connections </settings/restrict-outgoing-connections>
+   Set Default Sort Order </settings/set-default-sort>
    Show Kerberos Password </settings/show-kerberos-password>
    Hide Credentials </settings/protect-connection-strings>
    Block Write Operations </settings/read-only>

source/settings/set-default-sort.txt

@@ -0,0 +1,68 @@
+.. _compass-sort-query-bar:
+
+======================
+Set Default Sort Order
+======================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+You can specify a default sort order for documents shown in Compass through the
+:guilabel:`Settings` panel. 
+
+.. note::
+
+   If you specify a sort order through a query in the Query Bar, the sort order
+   that you specify in the query overrides the default sort order.
+
+If you :ref:`save a query <compass-favorite-queries>`, Compass does not save
+the default sort order as part of the saved query.  
+
+About This Task
+---------------
+
+You can choose one of the following default sort options:
+
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 20 80
+
+   * - Sort Key
+     - Description
+
+   * - $natural: 1
+     - Sort in the natural order of documents
+
+   * - $natural: -1
+     - Sort in reverse natural order of documents
+
+   * - _id: 1
+     - Sort in ascending order by the ``_id`` field
+
+   * - _id: -1
+     - Sort in descending order by the ``_id`` field
+
+Procedure
+---------
+
+.. procedure:: 
+   :style: normal
+   
+   .. include:: includes/fact-navigate-to-settings.rst
+
+   .. step:: Open the :guilabel:`Default Sort for Query Bar` dropdown menu.
+
+   .. step:: Select the default sort order you would like to use.
+
+   .. step:: Click :guilabel:`Save`. 
+
+.. note:: 
+
+   If you do not specify a default sort order, Compass uses the MongoDB server
+   default sort order of ``$natural: 1``, unless otherwise specified in the
+   Query Bar.
+

source/settings/settings-reference.txt

@@ -79,6 +79,12 @@ You can configure the following settings on the |compass| interface:
 
        To learn more, see :ref:`compass-protect-connection-strings`.
 
+   * - Default Sort for Query Bar
+     - General
+     - Defines how Compass sorts documents.
+
+       To learn more, see :ref:`compass-sort-query-bar`. 
+
    * - Show Kerberos Password Field 
      - General
      - Show or hide the Kerberos password field on the |compass-short|