DOCSP-16492 added sidebar TOC to all pages (#96)

* added sidebar TOC to all pages

Author: kyuan-mongodb

source/fundamentals/builders.txt

@@ -3,7 +3,7 @@ Builders
 ========
 
 .. default-domain:: mongodb
-
+   
 .. toctree::
 
    /fundamentals/builders/aggregates

source/fundamentals/connection.txt

@@ -3,7 +3,7 @@ Connection Guide
 ================
 
 .. default-domain:: mongodb
-
+   
 .. toctree::
 
    /fundamentals/connection/tls

source/fundamentals/crud/read-operations/cursor.txt

@@ -9,7 +9,7 @@ Access Data From a Cursor
    :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
 large number of documents, we need to be able to access or store the

source/fundamentals/crud/read-operations/limit.txt

@@ -4,6 +4,15 @@ Limit the Number of Returned Results
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Overview
+--------
+
 Use ``limit()`` to cap the number of documents that a read operation returns.
 This instance method designates the maximum number of
 documents that a read operation can return. If there are not enough documents
@@ -16,6 +25,9 @@ The examples below demonstrate, respectively, how to insert data into
 a collection, how to use ``limit()`` to restrict the number of returned documents,
 and how to combine ``limit()`` with ``skip()`` to further narrow the results returned from a query.
 
+Sample Documents
+~~~~~~~~~~~~~~~~
+
 The following operation inserts documents representing books into a collection:
 
 .. code-block:: java
@@ -37,6 +49,9 @@ The following operation inserts documents representing books into a collection:
             .append("author", "Martin")
     ));
 
+Specify a Limit
+---------------
+
 The next example queries the collection to return the top three
 longest books. It first matches all the documents with the query, then sorts on the
 ``length`` field to return books with longer lengths before
@@ -63,7 +78,6 @@ books with shorter lengths. Lastly, it limits the return value to ``3`` document
         cursor.close();
     }
 
-
 The code example above prints out the following three documents, sorted by
 length:
 
@@ -84,6 +98,8 @@ length:
       collection.find().sort(descending("length")).limit(3);
       collection.find().limit(3).sort(descending("length"));
 
+Combining Skip and Limit
+------------------------
 
 To see the next three longest books, append the ``skip()`` method to your
 ``find()`` call. The integer argument passed to ``skip()`` will determine
@@ -131,8 +147,6 @@ collection, returning only small subsets of the collection at one time.
   could return different documents for different queries. In this case, sorting
   by ``data`` or ``serial_no`` would guarantee a stable sort, as both are unique keys.
 
-
-
 For additional information on the classes and methods mentioned on this
 page, see the following API documentation:
 

source/fundamentals/crud/read-operations/skip.txt

@@ -4,6 +4,12 @@ Skip Returned Results
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
 In this guide, we show you how to skip a specified number of returned results.
 
 You can skip results on the returned results of a query by using the
@@ -33,7 +39,7 @@ You can use the ``Aggregates.skip()`` method to skip the first two documents as
    collection.aggregate(Arrays.asList(Aggregates.match(), Aggregates.skip(2))); 
 
 Examples
-~~~~~~~~
+--------
 
 The following example is about a paint store that sells eight different
 colors of paint.  The best colors sell quicker than the other colors.
@@ -57,8 +63,8 @@ To address the scenario, the paint store needs to query the
 ``paint_inventory`` collection with an empty filter, sort the documents
 by ``qty`` field and omit the first five results.
 
-Using the ``skip()`` method:
-````````````````````````````
+Using a FindIterable
+~~~~~~~~~~~~~~~~~~~~
 
 .. literalinclude:: /includes/fundamentals/code-snippets/Skip.java
    :language: java
@@ -70,8 +76,8 @@ Using the ``skip()`` method:
 - The ``sort()`` method specifies documents to display from highest to lowest based on the ``qty`` field.
 - The ``skip()`` method specifies to omit the first five documents. 
 
-Using ``Aggregates.skip()``:
-````````````````````````````
+Using Aggregation
+~~~~~~~~~~~~~~~~~
 
 .. literalinclude:: /includes/fundamentals/code-snippets/Skip.java
    :language: java

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: 2
+   :class: singlecol
+
 In this page, you can learn how to change documents in a MongoDB collection
 using two distinct operation types: 
 
@@ -49,8 +55,8 @@ You can call the ``updateOne()`` and ``updateMany()`` methods on a
 
     collection.updateMany(query, updateDocument);
 
-Update Operation Parameters:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Update Operation Parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - ``query`` specifies a query filter with the criteria to match documents to update in your collection
 - ``updateDocument`` specifies the fields and values to change in the matching document or documents. For this example, we use the :doc:`Updates builder </fundamentals/builders/updates>` to create the update document.
@@ -66,7 +72,7 @@ See the MongoDB API documentation for a :java-core-api:`complete list of
 Updates builders and their usage <com/mongodb/client/model/Updates.html>`.
 
 Example
-~~~~~~~
+```````
 
 The paint store receives a fresh shipment and needs to update their inventory.
 The shipment contains 20 cans of each paint color.
@@ -134,14 +140,14 @@ instance as follows:
 
     collection.replaceOne(query, replacementDocument);
 
-Replace Operation Parameters:
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Replace Operation Parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - ``query`` specifies a query filter with the criteria to match a document to replace in your collection
 - ``replacementDocument`` specifies fields and values of a new ``Document`` object to replace in the matched document 
 
 Example
-~~~~~~~
+```````
 
 The paint store realizes they need to update their inventory again.  What they
 thought was 20 cans of pink paint is actually 25 cans of orange paint. 

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: 2
+   :class: singlecol
+
 Overview
 --------
 
@@ -31,8 +37,8 @@ projection on the returned document, use
 :java-docs:`FindOneAndDeleteOptions </apidocs/mongodb-driver-core/com/mongodb/client/model/FindOneAndDeleteOptions.html>`
 as the second parameter to the ``findOneAndDelete()`` method.
 
-Examples
---------
+Sample Documents
+~~~~~~~~~~~~~~~~
 
 The following examples are about a paint store that sells eight different
 colors of paint. The store had their annual online sale resulting in the
@@ -49,8 +55,8 @@ following documents in their ``paint_inventory`` collection:
     { "_id": 7, "color": "green", "qty": 0 }
     { "_id": 8, "color": "black", "qty": 8 }
 
-``deleteMany()``
-````````````````
+Delete Many Documents
+---------------------
 
 The paint store website displays all documents in the
 ``paint_inventory`` collection. To reduce customer confusion, the store
@@ -76,8 +82,8 @@ collection:
     { "_id": 5, "color": "yellow", "qty": 6 }
     { "_id": 8, "color": "black", "qty": 8 }
 
-``deleteOne()``
-```````````````
+Delete a Document
+-----------------
 
 The store is donating the remaining quantity of their yellow paint. This
 means that the ``qty`` for yellow is now ``0`` and we need to remove yellow
@@ -102,8 +108,8 @@ collection:
     { "_id": 2, "color": "purple", "qty": 8 }
     { "_id": 8, "color": "black", "qty": 8 }
 
-``findOneAndDelete()``
-``````````````````````
+Find and Delete a Document
+--------------------------
 
 The store would like to raffle the remaining quantity of purple paint
 and remove purple from the ``paint_inventory`` collection. 

source/fundamentals/crud/write-operations/upsert.txt

@@ -2,6 +2,14 @@
 Insert or Update in a Single Operation
 ======================================
 
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
 Applications use insert and update operations to store and modify data.
 Sometimes, you need to choose between an insert and update depending on
 whether the document exists. MongoDB simplifies this decision for us
@@ -12,8 +20,8 @@ An ``upsert``:
 - Updates documents that match your query filter 
 - Inserts a document if there are no matches to your query filter
 
-Specify an Upsert:
-------------------
+Specify an Upsert
+-----------------
 
 To specify an upsert with the ``updateOne()`` or ``updateMany()``
 methods, pass ``true`` to :java-docs:`UpdateOptions.upsert()

source/fundamentals/data-formats/documents.txt

@@ -287,7 +287,7 @@ For more information on this class, see the
 :java-docs:`BsonDocument API documentation </apidocs/bson/org/bson/BsonDocument.html>`.
 
 JsonObject
--------------
+----------
 
 The ``JsonObject`` class acts as a wrapper for JSON strings.
 If you only want to work with JSON data, you can use ``JsonObject``

source/fundamentals/databases-collections.txt

@@ -4,6 +4,12 @@ Databases and Collections
 
 .. default-domain:: mongodb
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
 Overview
 --------