review comments

Author: lindseymoore

source/upgrade.txt

@@ -43,16 +43,16 @@ Before you upgrade, perform the following actions:
    To ensure compatibility across {+mdb-server+} versions when
    upgrading driver versions, use the :ref:`{+stable-api+} <php-stable-api>`.
 
-To upgrade your driver version, replace "version number" with the version number 
+To upgrade your driver version, replace ``<version-number>`` with the version number 
 you want to upgrade to and run the following command in your application's 
 directory:
 
 .. code-block:: bash
 
-   composer require mongodb/mongodb:<version number>
+   composer require mongodb/mongodb:<version-number>
 
 Installation instructions for the ``mongodb`` extension may be found in the 
-`PHP.net documentation <https://www.php.net/manual/en/mongodb.installation.php>`__.
+:php:`PHP.net documentation <manual/en/mongodb.installation.php>`.
 
 .. _php-breaking-changes:
 
@@ -77,14 +77,14 @@ This driver version introduces the following breaking changes:
 
 - Drops support for {+mdb-server+} 3.6.
 
-- Deprecate iterators for database, collection, and index enumeration.
+- Deprecates iterators for database, collection, and index enumeration.
 
 Version 1.18 Breaking Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This driver version introduces the following breaking changes:
 
-- Deprecate setting ``disableMD5`` to ``false`` when instantiating a Bucket due to 
+- Deprecates setting ``disableMD5`` to ``false`` when instantiating a Bucket due to 
   deprecated MD5 encoding. The default value for the setting is now ``true``. 
 
 Version 1.17 Breaking Changes
@@ -96,7 +96,7 @@ This driver version introduces the following breaking changes:
 
 - Requires PHP 7.4 or newer.
 
-- Remove aggregate compatibility logic, like the ``useCursor`` option, for 
+- Removes aggregate compatibility logic, like the ``useCursor`` option, for 
   {+mdb-server+} versions less than 3.6.
 
 Version 1.16 Breaking Changes
@@ -106,14 +106,14 @@ This driver version introduces the following breaking changes:
 
 - Upgrades the ``mongodb`` extension requirement to 1.16.0.
 
-- Deprecate ``IndexInfo::isGeoHaystack()``. ``geoHaystack`` was removed in
+- Deprecates ``IndexInfo::isGeoHaystack()``. ``geoHaystack`` was removed in
   {+mdb-server+} 5.0 and later.
 
-- Drop support for Composer 1.x.
+- Drops support for Composer 1.x.
 
-- Remove ``$server`` argument in ``Explainable::getCommandDocument``.
+- Removes ``$server`` argument in ``Explainable::getCommandDocument``.
 
-- Remove ``getNonce`` command usage for {+mdb-server+} 6.2 and later.
+- Removes ``getNonce`` command usage for {+mdb-server+} 6.2 and later.
 
 Version 1.15 Breaking Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~