DOCSP-17659 replaced above and below (#144)

* replaced above/below with preceding/following

Author: kyuan-mongodb

source/faq.txt

@@ -213,14 +213,14 @@ Imagine we are connecting to a collection that contains only this document:
          :start-after: start current-api-example
          :end-before: end current-api-example
 
-The output of the above code snippet should look like this:
+The output of the preceding code snippet should look like this:
 
 .. code-block:: json
    :copyable: false
 
    {"_id": 1, "val": 1}
 
-For more information on the legacy classes and methods used in the above example,
+For more information on the legacy classes and methods used in the preceding example,
 see the following API Documentation pages:
 
 - :java-docs:`Legacy API Javadoc Site <apidocs/mongodb-driver-legacy/index.html>`
@@ -260,7 +260,7 @@ Here is an example showing how to use the legacy ``MongoClientOptions`` and
          :start-after: start current-api-mongoclientsettings-example
          :end-before: end current-api-mongoclientsettings-example
 
-For more information on the legacy classes and methods used in the above example,
+For more information on the legacy classes and methods used in the preceding example,
 see the following API Documentation pages:
 
 - :java-docs:`Legacy API Javadoc Site <apidocs/mongodb-driver-legacy/index.html>`

source/fundamentals/aggregation.txt

@@ -143,7 +143,7 @@ In the following example, the aggregation pipeline:
    :start-after: begin aggregation one
    :end-before: end aggregation one
 
-The above aggregation should produce the following results:
+The preceding aggregation should produce the following results:
 
 .. code-block:: none
    :copyable: false
@@ -178,7 +178,7 @@ winning plans for aggregation stages that produce execution plans:
    :start-after: begin aggregation three
    :end-before: end aggregation three
 
-The above code snippet should produce the following output:
+The preceding code snippet should produce the following output:
 
 .. code-block:: none
    :copyable: false
@@ -236,7 +236,7 @@ first element in the ``categories`` field.
    :start-after: begin aggregation two
    :end-before: end aggregation two
 
-The above aggregation should produce the following results:
+The preceding aggregation should produce the following results:
 
 .. code-block:: none
    :copyable: false

source/fundamentals/builders/filters.txt

@@ -63,7 +63,7 @@ type, which you can pass to any method that expects a query filter.
 
       import static com.mongodb.client.model.Filters.*;
 
-   The examples below assume this static import.
+   The following examples assume this static import.
 
 The Filter examples in this guide use the following sample collections:
 
@@ -151,7 +151,7 @@ the value of the ``qty`` field equals "5" in the ``paint_purchases`` collection:
    :start-after: begin equalComparison
    :end-before: end equalComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false
@@ -169,7 +169,7 @@ the value of the ``qty`` field is greater than or equal to "10" in the
    :start-after: begin gteComparison
    :end-before: end gteComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false
@@ -186,7 +186,7 @@ the ``paint_purchases`` collection because the predicate is empty:
    :start-after: begin emptyComparison
    :end-before: end emptyComparison
 
-The output of the query using the operator specified above consists of
+The output of the preceding query consists of
 all the documents in the collection.
 
 .. code-block:: json
@@ -234,7 +234,7 @@ of the ``color`` field equals "pink" in the ``paint_purchases`` collection:
    :start-after: begin orComparison
    :end-before: end orComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false
@@ -277,7 +277,7 @@ containing both "A" and "D" in the ``paint_purchases`` collection:
    :start-after: begin allComparison
    :end-before: end allComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false
@@ -315,7 +315,7 @@ its value does not equal "5" or "8" in the ``paint_purchases`` collection:
    :start-after: begin existsComparison
    :end-before: end existsComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false
@@ -362,7 +362,7 @@ starting with the letter "p" in the ``paint_purchases`` collection:
    :start-after: begin regexComparison
    :end-before: end regexComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false
@@ -409,7 +409,7 @@ with bits set at positions of the corresponding bitmask "34" (i.e.
    :start-after: begin bitsComparison
    :end-before: end bitsComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false
@@ -470,7 +470,7 @@ in the ``geo_points`` collection:
    :start-after: begin geoWithinComparison
    :end-before: end geoWithinComparison
 
-The following shows the output of the query using the operator specified above:
+The following shows the output of the preceding query:
 
 .. code-block:: json
    :copyable: false

source/fundamentals/builders/indexes.txt

@@ -47,7 +47,7 @@ instance, which you can pass to
 
       import static com.mongodb.client.model.Indexes.*;
 
-   The examples below assume this static import.
+   The following examples assume this static import.
 
 .. _ascending-indexes:
 

source/fundamentals/builders/projections.txt

@@ -43,7 +43,7 @@ to any method that expects a projection.
       :language: java
       :dedent:
 
-   The examples below assume this static import.
+   The following examples assume this static import.
 
 Sample Documents and Examples
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/fundamentals/builders/sort.txt

@@ -87,7 +87,7 @@ on the ``_id`` field:
 
    collection.find().sort(ascending("_id"));
 
-The output of the example above should look something like this: 
+The output of the preceding example should look something like this: 
 
 .. code-block:: json
    :copyable: false
@@ -115,7 +115,7 @@ on the ``_id`` field:
 
    collection.find().sort(descending("_id"));
 
-The above example should output something like this: 
+The preceding example should output something like this: 
 
 .. code-block:: json
    :copyable: false
@@ -149,7 +149,7 @@ on the ``letter`` field, and in the event of a tie, ascending order on the
    Bson orderBySort = orderBy(descending("letter"), ascending("_id"));
    collection.find().sort(orderBySort);
 
-The output of the example above should look something like this: 
+The output of the preceding example should look something like this: 
 
 .. code-block:: json
    :copyable: false

source/fundamentals/builders/updates.txt

@@ -42,7 +42,7 @@ type, which you can pass to any method that expects an update argument.
 
       import static com.mongodb.client.model.Updates.*;
 
-   The examples below assume this static import.
+   The following examples assume this static import.
 
 The examples in this guide use the following document: 
 
@@ -75,7 +75,7 @@ The following example sets the value of the ``qty`` field to "11":
    :start-after: begin setUpdate
    :end-before: end setUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -101,7 +101,7 @@ The following example deletes the ``qty`` field:
    :start-after: begin unsetUpdate
    :end-before: end unsetUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -128,7 +128,7 @@ if an upsert resulted in the insert of a document:
    :start-after: begin setOnInsertUpdate
    :end-before: end setOnInsertUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -159,7 +159,7 @@ The following example increments the value of the ``qty`` field by
    :start-after: begin incUpdate
    :end-before: end incUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -186,7 +186,7 @@ The following example multiplies the value of the ``qty`` field by
    :start-after: begin mulUpdate
    :end-before: end mulUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -212,7 +212,7 @@ The following example renames the ``qty`` field to "quantity":
    :start-after: begin renameUpdate
    :end-before: end renameUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -237,7 +237,7 @@ specified in an update operation.
    :start-after: begin minUpdate
    :end-before: end minUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -265,7 +265,7 @@ maximum of its current value and "8":
    :start-after: begin maxUpdate
    :end-before: end maxUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
   :copyable: false
@@ -293,7 +293,7 @@ the current date as a BSON date:
    :start-after: begin currentDateUpdate
    :end-before: end currentDateUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
   :copyable: false
@@ -321,7 +321,7 @@ the current date as a BSON timestamp:
    :start-after: begin currentTimestampUpdate
    :end-before: end currentTimestampUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
   :copyable: false
@@ -361,7 +361,7 @@ The bitwise operation results in 15:
    ----
    1111
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -394,7 +394,7 @@ the ``vendor`` field:
    :start-after: begin addToSetUpdate
    :end-before: end addToSetUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -423,7 +423,7 @@ of the ``vendor`` field:
    :start-after: begin popFirstUpdate
    :end-before: end popFirstUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -450,7 +450,7 @@ The following example removes vendor "A" and "M" from the ``vendor`` array:
    :start-after: begin pullAllUpdate
    :end-before: end pullAllUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
   :copyable: false
@@ -478,7 +478,7 @@ array:
    :start-after: begin pullUpdate
    :end-before: end pullUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
   :copyable: false
@@ -504,7 +504,7 @@ The following examples pushes "C" to the ``vendor`` array:
    :start-after: begin pushUpdate
    :end-before: end pushUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false
@@ -522,7 +522,8 @@ The example above updates the original document to the following state:
 Combining Multiple Update Operators
 -----------------------------------
 An application can update multiple fields of a single document by
-combining two or more of the update operators described above. 
+combining two or more of the update operators described in the preceding
+sections. 
 
 The following example increments the value of the ``qty`` field by "6", sets
 the value of the ``color`` field to "purple", and pushes "R" to
@@ -534,7 +535,7 @@ the ``vendor`` field:
    :start-after: begin combineUpdate
    :end-before: end combineUpdate
 
-The example above updates the original document to the following state:
+The preceding example updates the original document to the following state:
 
 .. code-block:: json
    :copyable: false