DOCSP-37027: Fix build errors

docs/includes/extracts-option-requires.yaml

@@ -1,48 +1,43 @@
 ---
 ref: option-requires-4.2
-source:
-  ref: option-requires-version
-  file: extracts-option-requires.yaml
+content: |
+  This option is available since MongoDB {{version}} and will result in an
+  exception at execution time if specified for an older server version.
 replacement:
   version: "4.2"
 ---
 ref: option-requires-4.4
-source:
-  ref: option-requires-version
-  file: extracts-option-requires.yaml
+content: |
+  This option is available since MongoDB {{version}} and will result in an
+  exception at execution time if specified for an older server version.
 replacement:
   version: "4.4"
 ---
 ref: option-requires-5.0
-source:
-  ref: option-requires-version
-  file: extracts-option-requires.yaml
+content: |
+  This option is available since MongoDB {{version}} and will result in an
+  exception at execution time if specified for an older server version.
 replacement:
   version: "5.0"
 ---
 ref: option-requires-5.3
-source:
-  ref: option-requires-version
-  file: extracts-option-requires.yaml
+content: |
+  This option is available since MongoDB {{version}} and will result in an
+  exception at execution time if specified for an older server version.
 replacement:
   version: "5.3"
 ---
 ref: option-requires-6.0
-source:
-  ref: option-requires-version
-  file: extracts-option-requires.yaml
+content: |
+  This option is available since MongoDB {{version}} and will result in an
+  exception at execution time if specified for an older server version.
 replacement:
   version: "6.0"
 ---
 ref: option-requires-7.0
-source:
-  ref: option-requires-version
-  file: extracts-option-requires.yaml
-replacement:
-  version: "7.0"
----
-ref: option-requires-version
 content: |
   This option is available since MongoDB {{version}} and will result in an
   exception at execution time if specified for an older server version.
+replacement:
+  version: "7.0"
 ...

docs/reference.txt

@@ -12,8 +12,6 @@ API Documentation
    /reference/class/MongoDBDatabase
    /reference/class/MongoDBCollection
    /reference/class/MongoDBGridFSBucket
-   /reference/write-result-classes
    /reference/result-classes
-   /reference/enumeration-classes
    /reference/functions
    /reference/exception-classes

docs/reference/method/MongoDBClient-addSubscriber.txt

@@ -17,8 +17,8 @@ Definition
 
 .. phpmethod:: MongoDB\Client::addSubscriber()
 
-    Registers a monitoring event subscriber with this Client. The subscriber
-    will be notified of all events for this Client.
+   Registers a monitoring event subscriber with this Client. The subscriber
+   will be notified of all events for this Client.
 
    .. code-block:: php
 
@@ -50,8 +50,8 @@ notified once of each event for this Client.
 Example
 -------
 
-Create a :phpclass:`MongoDB\Driver\Monitoring\CommandSubscriber` that
-logs all events:
+Create a :php:`MongoDB\Driver\Monitoring\CommandSubscriber <manual/en/class.mongodb-driver-monitoring-commandsubscriber>`
+that logs all events:
 
 .. code-block:: php
 

docs/reference/method/MongoDBClient-removeSubscriber.txt

@@ -17,7 +17,7 @@ Definition
 
 .. phpmethod:: MongoDB\Client::removeSubscriber()
 
-    Unregisters a monitoring event subscriber with this Client.
+   Unregisters a monitoring event subscriber with this Client.
 
    .. code-block:: php
 

docs/reference/method/MongoDBCollection-bulkWrite.txt

@@ -30,12 +30,12 @@ Parameters
 ``$operations`` : array
   An array containing the write operations to perform.
   :phpmethod:`MongoDB\Collection::bulkWrite()` supports
-  :phpmethod:`deleteMany() <MongoDB\Collection::deleteMany>`,
-  :phpmethod:`deleteOne() <MongoDB\Collection::deleteOne>`,
-  :phpmethod:`insertOne() <MongoDB\Collection::insertOne>`,
-  :phpmethod:`replaceOne() <MongoDB\Collection::replaceOne>`,
-  :phpmethod:`updateMany() <MongoDB\Collection::updateMany>`, and
-  :phpmethod:`updateOne() <MongoDB\Collection::updateOne>` operations in the
+  :phpmethod:`MongoDB\Collection::deleteMany()`,
+  :phpmethod:`MongoDB\Collection::deleteOne()`,
+  :phpmethod:`MongoDB\Collection::insertOne()`,
+  :phpmethod:`MongoDB\Collection::replaceOne()`,
+  :phpmethod:`MongoDB\Collection::updateMany()`, and
+  :phpmethod:`MongoDB\Collection::updateOne()` operations in the
   following array structure:
 
   .. code-block:: php

docs/reference/method/MongoDBCollection-dropIndex.txt

@@ -29,8 +29,7 @@ Parameters
 
 ``$indexName`` : string| :phpclass:`MongoDB\Model\IndexInfo`
   The name or model object of the index to drop. View the existing indexes on
-  the collection using the :phpmethod:`listIndexes()
-  <MongoDB\Collection::listIndexes>` method.
+  the collection using the :phpmethod:`MongoDB\Collection::listIndexes()` method.
 
 ``$options`` : array
   An array specifying the desired options.

docs/reference/method/MongoDBCollection-dropIndexes.txt

@@ -27,8 +27,7 @@ Parameters
 
 ``$indexName`` : string| :phpclass:`MongoDB\Model\IndexInfo`
   The name or model object of the index to drop. View the existing indexes on
-  the collection using the :phpmethod:`listIndexes()
-  <MongoDB\Collection::listIndexes>` method.
+  the collection using the :phpmethod:`MongoDB\Collection::listIndexes()` method.
 
 ``$options`` : array
   An array specifying the desired options.

docs/reference/method/MongoDBCollection-explain.txt

@@ -29,7 +29,7 @@ Definition
 Parameters
 ----------
 
-``$explainable`` : :phpclass:`MongoDB\Operation\Explainable`
+``$explainable`` : ``MongoDB\Operation\Explainable``
   The command to explain.
 
 ``$options`` : array

docs/reference/method/MongoDBCollection-findOneAndUpdate.txt

@@ -33,7 +33,7 @@ Parameters
 
 ``$update`` : array|object
   Specifies the field and value combinations to update and any relevant update
-  operators. ``$update`` uses MongoDB's :method:`update operators
+  operators. ``$update`` uses MongoDB's :manual:`update operators
   </reference/operator/update>`. Starting with MongoDB 4.2, an `aggregation
   pipeline <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
   can be passed as this parameter.

docs/reference/method/MongoDBCollection-updateMany.txt

@@ -33,9 +33,9 @@ Parameters
 
 ``$update`` : array|object
   Specifies the field and value combinations to update and any relevant update
-  operators. ``$update`` uses MongoDB's :method:`update operators
-  </reference/operator/update>`. Starting with MongoDB 4.2, an `aggregation
-  pipeline <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
+  operators. ``$update`` uses MongoDB's :manual:`update operators </reference/operator/update>`.
+  Starting with MongoDB 4.2, an `aggregation pipeline
+  <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
   can be passed as this parameter.
 
 ``$options`` : array

docs/reference/method/MongoDBCollection-updateOne.txt

@@ -35,7 +35,7 @@ Parameters
 
 ``$update`` : array|object
   Specifies the field and value combinations to update and any relevant update
-  operators. ``$update`` uses MongoDB's :method:`update operators
+  operators. ``$update`` uses MongoDB's :manual:`update operators
   </reference/operator/update>`. Starting with MongoDB 4.2, an `aggregation
   pipeline <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
   can be passed as this parameter.

docs/reference/method/MongoDBDatabase-createCollection.txt

@@ -296,7 +296,7 @@ Parameters
          rules or expressions. You can specify the expressions using the same
          operators as MongoDB's
          :manual:`query operators </reference/operator/query>` with the
-         exception of :query:`$geoNear`, :query:`$near`, :query:`$nearSphere`,
+         exception of :query:`$near`, :query:`$nearSphere`,
          :query:`$text`, and :query:`$where`.
 
          .. note::

docs/reference/method/MongoDBGridFSBucket-registerGlobalStreamWrapperAlias.txt

@@ -19,7 +19,7 @@ Definition
 
    Registers an alias for the bucket, which enables files within the bucket to
    be accessed using a basic filename string (e.g.
-   `gridfs://<bucket-alias>/<filename>`).
+   ``gridfs://<bucket-alias>/<filename>``).
 
    .. code-block:: php
 
@@ -58,7 +58,7 @@ revision is read (revision ``-1``).
 In write mode, the stream context can contain the option ``gridfs['chunkSizeBytes']``.
 If omitted, the defaults are inherited from the ``Bucket`` instance option.
 
-The functions `rename` and `unlink` will rename or remove all revisions of a
+The functions ``rename`` and ``unlink`` will rename or remove all revisions of a
 filename. If the filename does not exist, these functions throw a ``FileNotFoundException``.
 
 Example

docs/reference/result-classes.txt

@@ -10,7 +10,7 @@ Result Classes
    BulkWriteResult Class </reference/class/MongoDBBulkWriteResult>
    DeleteResult Class </reference/class/MongoDBDeleteResult>
    InsertManyResult Class </reference/class/MongoDBInsertManyResult>
-   InsertOneResult Class </reference/class/MongoDInsertOneResult>
+   InsertOneResult Class </reference/class/MongoDBInsertOneResult>
    UpdateResult Class </reference/class/MongoDBUpdateResult>
    ChangeStream Class </reference/class/MongoDBChangeStream>
    MapReduceResult Class </reference/class/MongoDBMapReduceResult>

docs/tutorial/encryption.txt

@@ -19,16 +19,15 @@ To get started using in-use encryption in your project, the
 to be compiled with `libmongocrypt <https://github.com/mongodb/libmongocrypt>`_
 (enabled by default).
 
-Additionally, either `crypt_shared`_ or `mongocryptd`_ are required in order to
+Additionally, either ``crypt_shared`` or ``mongocryptd`` are required in order to
 use *automatic* client-side encryption. Neither is required for *explicit*
 encryption.
 
-
 crypt_shared
 ~~~~~~~~~~~~
 
 The :manual:`Automatic Encryption Shared Library </core/queryable-encryption/reference/shared-library/>`
-(crypt_shared) provides the same functionality as mongocryptd_, but does not
+(crypt_shared) provides the same functionality as ``mongocryptd``, but does not
 require you to spawn another process to perform automatic encryption.
 
 By default, the PHP driver attempts to load crypt_shared from the system path(s)
@@ -43,7 +42,6 @@ fail if it cannot be loaded.
 For detailed installation instructions see the MongoDB documentation for the
 :manual:`Automatic Encryption Shared Library </core/queryable-encryption/reference/shared-library/>`.
 
-
 mongocryptd
 ~~~~~~~~~~~
 
@@ -74,7 +72,6 @@ the spawning behavior via various auto encryption
 mongocryptd is only responsible for supporting automatic client-side encryption
 and does not itself perform any encryption or decryption.
 
-
 Managing Encryption Keys
 ------------------------
 
@@ -105,7 +102,6 @@ encryption key (e.g. user-specific encryption keys) or create them dynamically.
 .. literalinclude:: /examples/encryption/create_data_key.php
    :language: php
 
-
 .. _alt_name:
 
 Referencing Encryption Keys by an Alternative Name
@@ -208,7 +204,7 @@ Explicit Encryption
 ~~~~~~~~~~~~~~~~~~~
 
 Explicit encryption is a MongoDB community feature and does not use
-crypt_shared_ or mongocryptd_. Explicit encryption is provided by the
+``crypt_shared`` or ``mongocryptd``. Explicit encryption is provided by the
 :php:`MongoDB\Driver\ClientEncryption <mongodb-driver-clientencryption>` class.
 
 .. literalinclude:: /examples/encryption/csfle-explicit_encryption.php

docs/tutorial/gridfs.txt

@@ -35,7 +35,7 @@ The bucket can be constructed with various options:
   needed. The default size is ``261120`` (i.e. 255 KiB).
 - ``readConcern``, ``readPreference`` and ``writeConcern`` options can be used
   to specify defaults for read and write operations, much like the
-  :phpclass:`MongoDB\GridFS\Collection` options.
+  :phpclass:`MongoDB\Collection` options.
 
 Uploading Files with Writable Streams
 -------------------------------------