review comments

Author: lindseymoore

source/reference/class/MongoDBCollection.txt

@@ -1,5 +1,3 @@
-.. _api-mongodb-collection-class:
-
 =========================
 MongoDB\\Collection Class
 =========================

source/reference/function/add_logger.txt

@@ -1,5 +1,3 @@
-.. _api-add-logger:
-
 =====================
 MongoDB\\add_logger()
 =====================

source/reference/function/remove_logger.txt

@@ -1,5 +1,3 @@
-.. _api-remove-logger:
-
 ========================
 MongoDB\\remove_logger()
 ========================

source/reference/method/MongoDBClient-addSubscriber.txt

@@ -1,5 +1,3 @@
-.. _api-client-add-subscriber:
-
 ================================
 MongoDB\\Client::addSubscriber()
 ================================

source/reference/method/MongoDBClient-removeSubscriber.txt

@@ -1,5 +1,3 @@
-.. _api-client-remove-subscriber:
-
 ===================================
 MongoDB\\Client::removeSubscriber()
 ===================================

source/reference/method/MongoDBDatabase-createEncryptedCollection.txt

@@ -1,5 +1,3 @@
-.. _api-database-create-encrypted:
-
 ==============================================
 MongoDB\\Database::createEncryptedCollection()
 ==============================================

source/reference/method/MongoDBGridFSBucket-registerGlobalStreamWrapperAlias.txt

@@ -1,5 +1,3 @@
-.. _api-gridfs-bucket-register-global:
-
 ===========================================================
 MongoDB\\GridFS\\Bucket::registerGlobalStreamWrapperAlias()
 ===========================================================

source/whats-new.txt

@@ -35,28 +35,28 @@ following versions of the {+php-library+}:
 What's New in 1.20
 ------------------
 
-.. important:: MongoDB Server v3.6 End-of-Life
+.. important:: {+mdb-server+} v3.6 End-of-Life
 
-   Support for MongoDB Server v3.6 is removed in this release of the
+   Support for {+mdb-server+} v3.6 is removed in this release of the
    library.
 
-- Adds support for MongoDB Server v8.0.
+- Adds support for {+mdb-server+} v8.0.
 
 .. _php-lib-version-1.18:
 
 What's New in 1.18
 ------------------
 
 - Adds a new GridFS API to make it more convenient to work with files using PHP's 
-  existing filesystem functions. The :ref:`MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias() <api-gridfs-bucket-register-global>` 
+  existing filesystem functions. The :phpmethod:`MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias()` 
   method may be used to register a global alias for a GridFS bucket. After 
-  doing so, files within that bucket can be accessed using only a file URI 
+  doing so, files within that bucket can be accessed by using only a file URI 
   (e.g. "gridfs://mybucket/hello.txt"). A demonstration of this API can be found
   in the `gridfs_stream_wrapper.php <https://github.com/mongodb/mongo-php-library/blob/1.18.0/examples/gridfs_stream_wrapper.php>`__ 
   example script.
 
-- Adds :ref:`addSubscriber() <api-client-add-subscriber>` and 
-  :ref:`removeSubscriber()<api-client-remove-subscriber>` methods to the 
+- Adds :phpmethod:`MongoDB\Client::addSubscriber()` and 
+  :phpmethod:`MongoDB\Client::removeSubscriber()` methods to the 
   ``MongoDB\Client`` class to make it easier to register monitoring classes 
   on the underlying ``MongoDB\Driver\Manager`` object.
 
@@ -72,17 +72,20 @@ What's New in 1.17
   More information on this feature may be found in the 
   :ref:`Codecs tutorial <php-codecs>`.
 
-- Adds :ref:`MongoDB\add_logger() <api-add-logger>` and 
-  :ref:`MongoDB\remove_logger() <api-remove-logger>` functions to the library. 
+- Adds :phpmethod:`MongoDB\add_logger()` and 
+  :phpmethod:`MongoDB\remove_logger()` functions to the library. 
   These functions allow applications to register a `PSR-3 Logger <https://www.php-fig.org/psr/psr-3/>`__
   to receive log messages emitted by the driver. Previously, logs were only 
   accessible via the extension's `mongodb.debug <https://www.php.net/manual/en/mongodb.configuration.php#ini.mongodb.debug>`__ 
   INI setting.
 
-- Introduces new :ref:`MongoDB\Collection <api-mongodb-collection-class>` methods 
-  to create and manage :atlas:`Atlas Search indexes </atlas-search>`. Atlas 
-  Search indexes can be queried using the :manual:`$search </reference/operator/aggregation/search/>` 
+- Introduces new :phpclass:`MongoDB\Collection` methods to create and manage 
+  Atlas Search indexes. Atlas Search indexes can be queried using the ``$search`` 
   aggregation pipeline stage, which is supported in all versions of the library.
+  To learn more about Atlas Search indexes and the specfics of the ``$search`` 
+  aggregation stage, see the :atlas:`Atlas Search indexes </atlas-search>` 
+  documentation and :manual:`$search </reference/operator/aggregation/search/>`, 
+  respectively.
 
 - Upgrades the ``mongodb`` extension requirement to 1.17.0. Support for PHP 
   7.2 and 7.3 has been removed and the library now requires PHP 7.4 or newer.
@@ -97,7 +100,7 @@ What's New in 1.16
 
 - Introduces support for :v7.0:`MongoDB 7.0 </release-notes/7.0>`. 
 
-- Introduces :ref:`MongoDB\Database::createEncryptedCollection() <api-database-create-encrypted>`. 
+- Introduces :phpmethod:`MongoDB\Database::createEncryptedCollection()`. 
   This method automatically creates data encryption keys when creating a new 
   encrypted collection.
 
@@ -111,18 +114,18 @@ To learn more about this release, see the `v1.16 Release Notes
 What's New in 1.15
 ------------------
 
-- Adds new ``examples/`` and ``tools/`` directories to library repository, 
+- Adds new ``examples/`` and ``tools/`` directories to the library repository, 
   which contain code snippets and scripts that may prove useful when writing 
   or debugging applications, respectively. These directories are intended to 
-  supplement the library's existing documentation, and will be added to over time.
+  supplement the library's existing documentation and will be added to over time.
 
-- Various backwards compatible typing improvements have been made throughout the
+- Adds various backwards compatible typing improvements throughout the
   library. Downstream impact for these changes are discussed in 
   `UPGRADE-1.15.md <https://github.com/mongodb/mongo-php-library/blob/1.15.0/UPGRADE-1.15.md>`__. 
 
 - Integrates `Psalm <https://psalm.dev/>`__ for static analysis.
 
-- This release upgrades the ``mongodb`` extension requirement to 1.15.0.
+- Upgrades the ``mongodb`` extension requirement to 1.15.0.
 
 To learn more about this release, see the `v1.15 Release Notes 
 <https://github.com/mongodb/mongo-php-library/releases/tag/1.15.0>`__ on GitHub.