Clarifying filter example

Author: jeff-allen-mongo

Diff for: source/query/filter.txt

@@ -20,57 +20,56 @@ querying documents, see :manual:`Query Documents
 Set Query Filter
 ----------------
 
-#. In the :guilabel:`Filter` field, enter a filter document.
+#. In the :guilabel:`Filter` field, enter a filter document. You can use
+   all of the MongoDB :manual:`query operators
+   </reference/operator/query/>` except the :query:`$text` and
+   :query:`$expr` operators.
 
-   You can use all of the MongoDB
-   :manual:`query operators </reference/operator/query/>` except
-   the :query:`$text` and :query:`$expr` operators.
-
-   .. tip::
+   .. example::
 
-      In the :doc:`Schema </schema>` tab, you can also use the
-      :ref:`build-query` to enter a query into the query bar.
+      The following filter only returns documents which have a ``Country``
+      value of ``Brazil``:
+      
+      .. code-block:: json
+      
+         { Country: "Brazil" }
 
-   As you type, the :guilabel:`Find` button is disabled and the
-   :guilabel:`Filter` label turns red until a valid query is entered.
+#. .. include:: /includes/run-query.rst
 
-   .. figure:: /images/querybar/query-filter-error.png
+   .. figure:: /images/querybar/query-filter-success.png
       :figwidth: 600px
       :lightbox:
 
-   The Compass :guilabel:`Filter` supports using the
-   :binary:`~bin.mongo` shell mode representation of the MongoDB
-   Extended JSON :manual:`BSON data types </reference/mongodb-extended-json#bson-data-types-and-associated-representations>`.
+.. note::
 
-   .. example::
-
-      The following filter returns documents where
-      ``start_date`` is greater than than the BSON ``Date``
-      ``2017-05-01``:
+   .. include:: /includes/extracts/query-bar-results.rst
 
-      .. code-block:: javascript
+Supported Data Types in the Query Bar
+-------------------------------------
 
-         { "start_date": {$gt: new Date('2017-05-01')} }
+The Compass :guilabel:`Filter` supports using the
+:binary:`~bin.mongo` shell mode representation of the MongoDB
+Extended JSON :manual:`BSON data types </reference/mongodb-extended-json#bson-data-types-and-associated-representations>`.
 
-      By specifying the ``Date`` type in both ``start_date`` and the
-      ``$gt`` comparison operator, Compass performs the ``greater
-      than`` comparison chronologically, returning documents with
-      ``start_date`` later than ``2017-05-01``.
+.. example::
 
-      Without the ``Date`` type specification, Compass compares the
-      ``start_dates`` as strings
-      `lexicographically <https://en.wikipedia.org/wiki/Lexicographical_order>`_,
-      instead of comparing the values chronologically.
+   The following filter returns documents where
+   ``start_date`` is greater than than the BSON ``Date``
+   ``2017-05-01``:
 
-#. .. include:: /includes/run-query.rst
+   .. code-block:: javascript
 
-   .. figure:: /images/querybar/query-filter-success.png
-      :figwidth: 600px
-      :lightbox:
+      { "start_date": {$gt: new Date('2017-05-01')} }
 
-   .. note::
+   By specifying the ``Date`` type in both ``start_date`` and the
+   ``$gt`` comparison operator, Compass performs the ``greater
+   than`` comparison chronologically, returning documents with
+   ``start_date`` later than ``2017-05-01``.
 
-      .. include:: /includes/extracts/query-bar-results.rst
+   Without the ``Date`` type specification, Compass compares the
+   ``start_dates`` as strings
+   `lexicographically <https://en.wikipedia.org/wiki/Lexicographical_order>`_,
+   instead of comparing the values chronologically.
 
 
 Clear the Query
@@ -89,11 +88,10 @@ How Does the Compass Query Compare to MongoDB and SQL Queries?
    You have 3,235 articles. You would like to see all articles
    that Joe Bloggs wrote.
 
-   SQL
-      .. code-block:: sql
+   Compass Filter Option
+      .. code-block:: javascript
 
-         SELECT * FROM article
-         WHERE author = "Joe Bloggs";
+         { author : { $eq : "Joe Bloggs" } }
 
    MongoDB Aggregation
       .. code-block:: javascript
@@ -102,7 +100,8 @@ How Does the Compass Query Compare to MongoDB and SQL Queries?
            { $filter : { author : { $eq : "Joe Bloggs" } } }
          );
 
-   Compass Filter Option
-      .. code-block:: javascript
+   SQL
+      .. code-block:: sql
 
-         { author : { $eq : "Joe Bloggs" } }
+         SELECT * FROM article
+         WHERE author = "Joe Bloggs";