review comments

Author: lindseymoore

source/whats-new.txt

@@ -16,7 +16,7 @@ Learn what's new in:
 * :ref:`Version 5.1.2 <kotlin-sync-version-5.1.2>`
 * :ref:`Version 5.1.1 <kotlin-sync-version-5.1.1>`
 * :ref:`Version 5.1 <kotlin-sync-version-5.1>`
-* :ref:`Version 5.0 <version-5.0>`
+* :ref:`Version 5.0 <kotlin-sync-version-5.0>`
 
 .. _kotlin-sync-version-5.1.3:
 
@@ -59,9 +59,9 @@ The 5.1.1 driver patch release includes the following changes:
 
 - When using the ``MONGODB-OIDC`` authentication mechanism, you must not
   include comma characters in the ``authMechanismProperties`` connection
-  string value. To learn more about this behavior, see the
-  :ref:`MONGODB-OIDC <kotlin-oidc>` section of the Enterprise
-  Authentication guide.
+  string value. To learn more about this behavior, see
+  `MongoCredential <{+core-api+}/com/mongodb/MongoCredential.html>`__ in the 
+  API documentation.
 
 .. _kotlin-sync-version-5.1:
 
@@ -75,11 +75,11 @@ What's New in 5.1
 
 This section includes the following information:
 
-- :ref:`kotlin-deprecations-5.1`
-- :ref:`kotlin-improvements-5.1`
-- :ref:`kotlin-new-features-5.1`
+- :ref:`kotlin-sync-deprecations-5.1`
+- :ref:`kotlin-sync-improvements-5.1`
+- :ref:`kotlin-sync-new-features-5.1`
 
-.. _kotlin-deprecations-5.1:
+.. _kotlin-sync-deprecations-5.1:
 
 Deprecations in 5.1
 ~~~~~~~~~~~~~~~~~~~
@@ -89,7 +89,7 @@ Deprecations in 5.1
   deployment, see :manual:`Release Notes </release-notes>` in the {+mdb-server+}
   manual.
 
-.. _kotlin-improvements-5.1:
+.. _kotlin-sync-improvements-5.1:
 
 Improvements in 5.1
 ~~~~~~~~~~~~~~~~~~~
@@ -98,8 +98,9 @@ Improvements in 5.1
   native applications by using the GraalVM native-image tool.
 
 - Enhanced support for the ``MONGODB-OIDC`` authentication mechanism.
-  To learn more about OIDC, see the :ref:`kotlin-oidc` section of the
-  Enterprise Authentication Mechanisms guide.
+  To learn more about OIDC, see
+  `MongoCredential <{+core-api+}/com/mongodb/MongoCredential.html>`__ in the 
+  API documentation.
 
 - Fixes an issue in which operations used the incorrect codec when using
   a polymorphic ``MongoCollection`` instance. This ensures that
@@ -109,18 +110,20 @@ Improvements in 5.1
   when decoding, resulting in field type errors when using a polymorphic
   ``MongoCollection`` instance.
 
-.. _kotlin-new-features-5.1:
+.. _kotlin-sync-new-features-5.1:
 
 New Features in 5.1
 ~~~~~~~~~~~~~~~~~~~
 
-- Support for polymorphic serialization. To learn more, see the
-  :ref:`kotlin-polymorphic` section of the Kotlin Serialization guide.
+- Support for polymorphic serialization.
+
+.. TODO: Add link to Kotlin Serialization page when ready: https://jira.mongodb.org/browse/DOCSP-42666 . 
+.. ex. To learn more, see the :ref:`kotlin-sync-polymorphic` section of the Kotlin Sync Serialization guide.
 
 - Introduces the ``serverMonitoringMode`` connection URI option. To
   learn more, see the :ref:`kotlin-sync-connection-options` guide.
 
-.. _version-5.0:
+.. _kotlin-sync-version-5.0:
 
 What's New in 5.0
 -----------------