(DOCSP-8551) Add example queries to Query Your Data page (#214)

* (DOCSP-8551) Add example queries to Query Your Data page

* Changes based on copy review

* Simplified date example

* Changes from review

* Remove example block styling

Author: zach-carr

source/query/filter.txt

@@ -108,6 +108,173 @@ How Does the Compass Query Compare to MongoDB and SQL Queries?
          SELECT * FROM article
          WHERE author = "Joe Bloggs";
 
+Examples
+--------
+
+.. class:: example
+
+   The following examples use the JSON documents below as sample data. 
+   To import this sample data to your MongoDB deployment with |compass|:
+
+   1. Copy the array of documents below by clicking :guilabel:`Copy`.
+
+   .. code-block:: JSON
+
+      [
+         {
+            "_id":{"$oid":"5a9427648b0beebeb69579cc"},
+            "name":"Andrea Le",
+            "email":"[email protected]",
+            "version":5,
+            "scores":[85, 95, 75],
+            "dateCreated":{"$date":"2003-03-26"}
+         },
+         {
+            "_id":{"$oid":"5a9427648b0beebeb69579cf"},
+            "name":"Greg Powell",
+            "email":"[email protected]",
+            "version":1,
+            "scores":[65, 75, 80],
+            "dateCreated":{"$date":"1999-02-10"}
+         }
+      ]
+
+   2. In |compass-short|, use the left navigation panel to select the 
+      database and the collection you want to import the data to.
+   
+   #. Click the :guilabel:`Documents` tab.
+   
+   #. Click :guilabel:`Add Data` and select :guilabel:`Insert Document`.
+
+   #. Ensure that :guilabel:`View` is set to JSON, or ``{}``, and paste 
+      the copied JSON documents in the field.
+
+   #. Click :guilabel:`Insert`.
+
+.. note::
+
+   If you do not have a MonogDB deployment or if you would like to 
+   query a large sample data set, see
+   :atlas:`Sample Data for Atlas Clusters</sample-data/>` for 
+   instructions on creating a free-tier cluster with sample data. Note 
+   that the examples below are intended to filter the sample JSON 
+   documents provided on this page and may not properly filter another 
+   sample data set.
+
+.. tabs::
+
+   .. tab:: Filter for a Match
+      :tabid: match
+         
+      The following :ref:`query filter <query-bar-filter>` uses the 
+      :manual:`$eq operator </reference/operator/query/eq/>` to find 
+      all documents where ``name`` is "Andrea Le" .
+
+      .. code-block:: shell
+
+         { name: { $eq: "Andrea Le" } }
+
+      The query returns the following document because the ``name`` 
+      field value in the document is an exact match.
+
+      .. code-block:: JSON
+         :copyable: false
+
+         {
+            "_id":ObjectId("5a9427648b0beebeb69579cc"),
+            "name":"Andrea Le",
+            "email":"[email protected]",
+            "version":5,
+            "scores":[85, 95, 75],
+            "dateCreated":2003-03-26T00:00:00.000+00:00
+         }
+
+   .. tab:: Filter by Comparison
+      :tabid: compare
+         
+      The following :ref:`query filter <query-bar-filter>` uses the 
+      :manual:`$lte operator </reference/operator/query/lte/>` to 
+      find all documents where ``version`` is less than or equal 
+      to ``4``.
+
+      .. code-block:: shell
+
+         { version: { $lte: 4 } }
+
+      The query returns the following document because the value of 
+      the ``version`` field in the document is less than ``4``.
+
+      .. code-block:: JSON
+         :copyable: false
+
+         {
+            "_id":ObjectId("5a9427648b0beebeb69579cf"),
+            "name":"Greg Powell",
+            "email":"[email protected]",
+            "version":1,
+            "scores":[65, 75, 80],
+            "dateCreated":1999-02-10T00:00:00.000+00:00
+         }
+
+   .. tab:: Filter by Date
+      :tabid: date
+         
+      The following :ref:`query filter <query-bar-filter>` uses the 
+      :manual:`$gt operator </reference/operator/query/gt/>` and 
+      :manual:`Date() method </reference/method/Date/>` to find all 
+      documents where the ``dateCreated`` field value is later than 
+      June 22nd, 2000.
+
+      .. code-block:: shell
+
+         { dateCreated: { $gt: Date('2000-06-22') } }
+
+      The query returns the following document because the value of 
+      the ``dateCreated`` field is after June 22, 2000.
+
+      .. code-block:: JSON
+         :copyable: false
+
+         {
+            "_id":ObjectId("5a9427648b0beebeb69579cc"),
+            "name":"Andrea Le",
+            "email":"[email protected]",
+            "version":1,
+            "scores":[85, 95, 75],
+            "dateCreated":2003-03-26T00:00:00.000+00:00
+         }
+
+   .. tab:: Filter by Elements in an Array
+      :tabid: array
+         
+      The following :ref:`query filter <query-bar-filter>` uses the
+      :manual:`$elemMatch operator </reference/operator/query/elemMatch/>` to find all documents where at least one value in 
+      the ``scores`` array is greater than 80 and less than ``90`` 
+
+      .. code-block:: shell
+
+         { scores: { $elemMatch: { $gt: 80, $lt: 90 } } }
+
+      The query returns the following document because one of the 
+      values in the scores array is ``85``, which matches the 
+      ``$elemMatch`` criteria.
+
+      .. code-block:: JSON
+         :copyable: false
+
+         {
+            "_id":ObjectId("5a9427648b0beebeb69579cc"),
+            "name":"Andrea Le",
+            "email":"[email protected]",
+            "version":1,
+            "scores":[85, 95, 75],
+            "dateCreated":2003-03-26T00:00:00.000+00:00
+         }
+
+For more query examples, see 
+:manual:`Query Documents </tutorial/query-documents/>` 
+in the MongoDB manual.
+
 .. class:: hidden
 
    .. toctree::