DOCSP-19054 Query API Page (#729)

* DOCSP-19054 inital scaffolding

* update to messaging

* moving query-api to root

* CR 1

* toc update

* tweak TOC again

* adjust query api position in TOC

* CR updates to query-api bullet list and more

* geoWithin update

* Additional feedback updates

* bolding bullet points

* removing atlas search

* update data transformations bullet

* TR1 Add materialized view bullet

* add document join support bullet

* remove the

* remove last blank

Author: ianf-mongodb

source/introduction.txt

@@ -24,8 +24,8 @@ and arrays of documents.
 
 The advantages of using documents are:
 
-- Documents (i.e. objects) correspond to native data types in
-  many programming languages.
+- Documents correspond to native data types in many programming 
+  languages.
 
 - Embedded documents and arrays reduce need for expensive joins.
 
@@ -126,5 +126,6 @@ third parties to develop storage engines for MongoDB.
    Create an Atlas Free Tier Cluster <https://docs.atlas.mongodb.com/getting-started/>
    /core/databases-and-collections
    /core/document
+   /query-api
    /reference/bson-types
 

source/query-api.txt

@@ -0,0 +1,87 @@
+.. |query-api| replace:: Query API
+
+===================
+MongoDB |query-api|
+===================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The MongoDB |query-api| is the mechanism that you use to interact with 
+your data.
+
+The |query-api| comprises two ways to query data in MongoDB:
+
+- :doc:`CRUD Operations </crud>`
+- :doc:`Aggregation pipelines </core/aggregation-pipeline>`
+
+You can use the |query-api| to perform:
+
+- **Adhoc queries**. Explore your MongoDB data with :binary:`~bin.mongosh`,
+  `Compass <https://docs.mongodb.com/compass/current/>`_ , 
+  `VSCode <https://code.visualstudio.com/docs/azure/mongodb>`_ 
+  or a MongoDB :driver:`driver </>`.
+
+- **Data transformations**. Use 
+  :doc:`aggregation pipelines </core/aggregation-pipeline>` to 
+  reshape your data and perform calculations. 
+
+- **Document join support** Use :pipeline:`$lookup` and 
+  :pipeline:`$unionWith` to combine data from different collections.
+
+- **Graph and geospatial queries**. Use operators such as 
+  :query:`$geoWithin` and :pipeline:`$geoNear` to analyze geospatial 
+  data and :pipeline:`$graphLookup` for graph data.
+
+- **Full-text search**. Use the :pipeline:`$search` stage to 
+  perform efficient text search on your data.
+
+- **Indexing**. Improve your MongoDB query performance by using the correct
+  :ref:`index type <indexes>` for your data architecture.
+
+- **On-demand materialized views**. Use :pipeline:`$out` and 
+  :pipeline:`$merge` to :doc:`create materialized views 
+  </core/materialized-views>`
+  on common queries.
+
+- **Time series analysis**. Query and aggregate your time-stamped data 
+  with :ref:`time series collections <manual-timeseries-collection-create>`.
+
+Document Model
+--------------
+
+A document in MongoDB is a data structure composed of field and value 
+pairs. Documents are stored as BSON which is the binary representation of 
+:term:`JSON`. This low level of abstraction helps you develop quicker 
+and reduces the efforts around querying and data modeling. The document
+model provides several advantages, including:
+
+- Documents correspond to native data types in many programming 
+  languages.
+
+- Embedded documents and arrays reduce need for expensive joins.
+
+- Flexible schema. Documents do not need to have the same set of fields 
+  and the data type for a field can differ across documents within a 
+  collection.
+
+Data as Code
+------------
+
+The MongoDB |query-api| supports :driver:`drivers</>` for major 
+programming languages. These drivers allow you to make calls to the 
+database and generate queries using the syntax native to your 
+application.
+
+Getting Started
+---------------
+
+To get started, visit the MongoDB 
+:doc:`Getting Started Guide </tutorial/getting-started>`. Here you can
+find resources, code examples and tutorials that demonstrate the MongoDB
+|query-api|.