add to each page

Author: norareidy

source/crud/delete.txt

@@ -101,8 +101,8 @@ options you can set in the array:
 
    * - ``collation``
      - | Specifies the kind of language collation to use when comparing
-         strings. For more information, see :manual:`Collation </reference/collation/#std-label-collation>`
-         in the {+mdb-server+} manual.
+         strings. To learn more, see the :ref:`php-delete-collation` section
+         of this page.
 
    * - ``writeConcern``
      - | Sets the write concern for the operation. This option defaults to
@@ -152,6 +152,13 @@ operation:
    the preceding example, the library deletes only the first document that has
    a ``name`` value containing ``'Mongo'``.
 
+.. _php-delete-collation:
+
+Collation
+~~~~~~~~~
+
+.. include:: /includes/collation.rst
+
 Return Value
 ------------
 

source/crud/query/count.txt

@@ -120,7 +120,8 @@ describes some options you can set to customize the count operation:
      - Description
 
    * - ``collation``
-     - | The collation to use for the operation.
+     - | The collation to use for the operation. To learn more,
+         see the :ref:`php-count-collation` section of this page.
        | **Type**: ``array|object``
 
    * - ``hint``
@@ -166,6 +167,13 @@ operation to count a maximum of ``100`` results:
 
       Number of companies with 50 employees: 100
 
+.. _php-count-collation:
+
+Collation
+`````````
+
+.. include:: /includes/collation.rst
+
 .. _php-estimated-count:
 
 Retrieve an Estimated Count

source/crud/query/distinct.txt

@@ -123,7 +123,8 @@ options you can set to customize the operation:
      - Description
 
    * - ``collation`` 
-     - | The collation to use for the operation.
+     - | The collation to use for the operation. To learn more, see the
+         :ref:`php-distinct-collation` section of this page.
        | **Type**: ``array|object``
 
    * - ``maxTimeMS``
@@ -169,6 +170,13 @@ in an options array to add a comment to the operation:
       "Angie'S Cafe Pizza"
       ...
 
+.. _php-distinct-collation:
+
+Collation
+`````````
+
+.. include:: /includes/collation.rst
+
 API Documentation
 -----------------
 

source/crud/query/retrieve.txt

@@ -190,7 +190,8 @@ you can set in the array:
 
    * - ``collation`` 
      - | The collation to use for the operation. The default value is the collation
-         specified for the collection.
+         specified for the collection. To learn more, see the :ref:`php-retrieve-collation`
+         section of this page.
        | **Type**: ``array|object``
 
    * - ``comment`` 
@@ -233,6 +234,13 @@ For a full list of options, see the API documentation for the
 `findOne() <{+api+}/method/MongoDBCollection-findOne/#parameters>`__ and 
 `find() <{+api+}/method/MongoDBCollection-find/#parameters>`__ parameters.
 
+.. _php-retrieve-collation:
+
+Collation
+`````````
+
+.. include:: /includes/collation.rst
+
 .. _php-retrieve-additional-information:
 
 Additional Information

source/crud/replace.txt

@@ -159,8 +159,8 @@ table describes some options you can set in the array:
 
    * - ``collation``
      - | Specifies the kind of language collation to use when sorting
-         results. For more information, see :manual:`Collation </reference/collation/#std-label-collation>`
-         in the {+mdb-server+} manual.
+         results. To learn more, see the :ref:`php-replace-collation`
+         section of this page.
 
    * - ``hint``
      - | Gets or sets the index to scan for documents. 
@@ -197,6 +197,13 @@ filter doesn't match any existing documents:
    :language: php
    :copyable:
 
+.. _php-replace-collation:
+
+Collation
+~~~~~~~~~
+
+.. include:: /includes/collation.rst
+
 Additional Information 
 ----------------------
 

source/crud/update.txt

@@ -125,8 +125,8 @@ describes some options you can set in the array:
 
    * - ``collation``
      - | Specifies the kind of language collation to use when sorting
-         results. For more information, see :manual:`Collation </reference/collation/#std-label-collation>`
-         in the {+mdb-server+} manual.
+         results. To learn more, see the :ref:`php-update-collation` section
+         of this page.
 
    * - ``arrayFilters``
      - | Specifies which array elements an update applies to if the operation modifies
@@ -166,6 +166,13 @@ match any existing documents.
    :language: php
    :dedent:
 
+.. _php-update-collation:
+
+Collation
+`````````
+
+.. include:: /includes/collation.rst
+
 Return Value
 ~~~~~~~~~~~~
 

source/monitoring-logging/change-streams.txt

@@ -174,7 +174,8 @@ can set in the array:
        | This option is mutually exclusive with ``startAfter`` and ``resumeAfter``.
 
    * - ``collation``
-     - | Sets the collation to use for the change stream cursor.
+     - | Sets the collation to use for the change stream cursor. To learn more,
+         see the :ref:`php-change-stream-collation` section of this page.
 
 For a full list of ``watch()`` options, see `MongoDB\\Collection::watch()
 <{+api+}/method/MongoDBCollection-watch/>`__ in the API
@@ -255,6 +256,13 @@ output:
    :manual:`Change Streams with Document Pre- and Post-Images </changeStreams#change-streams-with-document-pre--and-post-images>` 
    in the {+mdb-server+} manual.
 
+.. _php-change-stream-collation:
+
+Collation
+~~~~~~~~~
+
+.. include:: /includes/collation.rst
+
 Additional Information
 ----------------------