DOCSP-16392 sidebar toc (#176)

kyuan-mongodb · web-flow · commit 3c05c11975c9 · 2021-06-03T17:57:16.000-04:00
* added sidebar TOC
diff --git a/source/fundamentals/authentication/enterprise-mechanisms.txt b/source/fundamentals/authentication/enterprise-mechanisms.txt
@@ -2,6 +2,12 @@
 Enterprise Authentication Mechanisms
 ====================================
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
 In this guide, you can find sample code for connection to MongoDB with each
 authentication mechanism available in the MongoDB Enterprise Edition:
 ``Kerberos (GSSAPI/SSPI)`` and  ``LDAP (PLAIN)``.
diff --git a/source/fundamentals/connection.txt b/source/fundamentals/connection.txt
@@ -2,6 +2,12 @@
 Connection Guide
 ================
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
 This guide shows you how to connect to a MongoDB instance or replica set
 deployment using the Node.js driver.
 
diff --git a/source/fundamentals/crud/compound-operations.txt b/source/fundamentals/crud/compound-operations.txt
@@ -4,6 +4,12 @@ Compound Operations
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
 Most database requests only need to read data out of a database or
 write data into a database. However, client applications sometimes need
 to read and write data in a single interaction with the database.
diff --git a/source/fundamentals/crud/query-document.txt b/source/fundamentals/crud/query-document.txt
@@ -4,8 +4,14 @@ Specify a Query
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+   
 Overview
-~~~~~~~~
+--------
 
 Most CRUD operations allow you to narrow the set of matched documents by
 specifying matching criteria in a **query document**. Query documents contain
diff --git a/source/fundamentals/crud/read-operations/cursor.txt b/source/fundamentals/crud/read-operations/cursor.txt
@@ -4,6 +4,12 @@ Access Data From a Cursor
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
 Read operations that return multiple documents do not immediately return
 all values matching the query. Because a query can potentially match
 very large sets of documents, these operations rely upon an
diff --git a/source/fundamentals/crud/read-operations/retrieve.txt b/source/fundamentals/crud/read-operations/retrieve.txt
@@ -7,7 +7,7 @@ Retrieve Data
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 2
+   :depth: 1
    :class: singlecol
 
 Overview
diff --git a/source/fundamentals/crud/read-operations/text.txt b/source/fundamentals/crud/read-operations/text.txt
@@ -4,6 +4,12 @@ Search Text
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
 Overview
 --------
 
diff --git a/source/fundamentals/crud/write-operations/change-a-document.txt b/source/fundamentals/crud/write-operations/change-a-document.txt
@@ -4,6 +4,12 @@ Change a Document
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
 Overview
 --------
 
diff --git a/source/fundamentals/crud/write-operations/delete.txt b/source/fundamentals/crud/write-operations/delete.txt
@@ -4,6 +4,12 @@ Delete a Document
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
 Overview
 --------
 
diff --git a/source/fundamentals/crud/write-operations/embedded-arrays.txt b/source/fundamentals/crud/write-operations/embedded-arrays.txt
@@ -4,6 +4,12 @@ Update Arrays in a Document
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
 If you need to modify an array embedded within a document, you can use an
 array update operator in your update method call. In this guide, we
 explain and show examples on usage of these operators including:
diff --git a/source/fundamentals/crud/write-operations/insert.txt b/source/fundamentals/crud/write-operations/insert.txt
@@ -4,6 +4,12 @@ Insert a Document
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+   
 Overview
 --------
 
diff --git a/source/fundamentals/monitoring.txt b/source/fundamentals/monitoring.txt
@@ -7,7 +7,7 @@ Monitoring
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 1
+   :depth: 2
    :class: singlecols
 
 Overview
diff --git a/source/fundamentals/promises.txt b/source/fundamentals/promises.txt
@@ -7,7 +7,7 @@ Promises and Callbacks
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 1
+   :depth: 2
    :class: singlecols
 
 Overview
diff --git a/source/usage-examples.txt b/source/usage-examples.txt
@@ -4,6 +4,12 @@ Usage Examples
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+   
 .. toctree::
 
    /usage-examples/find-operations
diff --git a/source/usage-examples/find.txt b/source/usage-examples/find.txt
@@ -4,15 +4,13 @@ Find Multiple Documents
 
 .. default-domain:: mongodb
 
-You can query for multiple documents in a collection with the
-``collection.find()`` method. The ``find()`` method uses a query
-document to determine what to include in the result set. A query
-document can contain query operators. Query operators are keywords that
-begin with a ``$`` that let you specify complex query behavior. If you
-don't provide a query document or if you provide an empty document,
-MongoDB returns all documents in the collection. For more information on
-how to use query documents and query operators, see our :doc:`guide on query documents
-</fundamentals/crud/query-document>`. 
+You can query for multiple documents in a collection with
+``collection.find()``. The ``find()`` method uses a query document that you
+provide to match the subset of the documents in the collection that match the
+query. If you don't provide a query document (or if you provide an empty
+document), MongoDB returns all documents in the collection. For more
+information on querying MongoDB, see our
+:doc:`documentation on query documents </fundamentals/crud/query-document>`.
 
 You can also define additional query options such as
 :doc:`sort </fundamentals/crud/read-operations/sort>`
diff --git a/source/usage-examples/findOne.txt b/source/usage-examples/findOne.txt
@@ -14,13 +14,12 @@ Find a Document
 
 You can query for a single document in a collection with the
 ``collection.findOne()`` method. The ``findOne()`` method uses a query
-document to determine what to include in the result set. A query
-document can contain query operators. Query operators are keywords that
-begin with a ``$`` that let you specify complex query behavior. If you
-don't provide a query document or if you provide an empty document,
-MongoDB returns the first matched document. For more information on how
-use query documents and query operators, see our :doc:`guide on query documents
-</fundamentals/crud/query-document>`. 
+document that you provide to match only the subset of the documents in the
+collection that match the query. If you don't provide a query document or if
+you provide an empty document, MongoDB matches all documents in the
+collection. The ``findOne()`` operation only returns the first matched
+document. For more information on querying MongoDB, see our
+:doc:`documentation on query documents </fundamentals/crud/query-document>`.
 
 You can also define additional query options such as
 :doc:`sort </fundamentals/crud/read-operations/sort>`
