From 33e4f112c7761495c2c3e753b531ab2784fdabb5 Mon Sep 17 00:00:00 2001
From: Steven Silvester <steven.silvester@ieee.org>
Date: Mon, 15 Sep 2025 15:54:53 -0500
Subject: [PATCH] MOTOR-1475 Update docs references (#346)

---
 doc/changelog.rst          | 2 +-
 doc/installation.rst       | 2 +-
 doc/migrate-to-motor-3.rst | 1 -
 motor/docstrings.py        | 6 +++---
 4 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/doc/changelog.rst b/doc/changelog.rst
index 2f0f214e..ec01e3e9 100644
--- a/doc/changelog.rst
+++ b/doc/changelog.rst
@@ -709,7 +709,7 @@ Highlights include:
 
 - Complete support for MongoDB 3.4:
 
-  - Unicode aware string comparison using collations. See :ref:`PyMongo's examples for collation <collation-on-operation>`.
+  - Unicode aware string comparison using collations.
   - :class:`MotorCursor` and :class:`MotorGridOutCursor` have a new attribute :meth:`~MotorCursor.collation`.
   - Support for the new :class:`~bson.decimal128.Decimal128` BSON type.
   - A new maxStalenessSeconds read preference option.
diff --git a/doc/installation.rst b/doc/installation.rst
index 539c694d..37842945 100644
--- a/doc/installation.rst
+++ b/doc/installation.rst
@@ -41,7 +41,7 @@ dependency can be installed automatically along with Motor::
 
 similarly,
 
-`MONGODB-AWS <https://pymongo.readthedocs.io/en/stable/examples/authentication.html#mongodb-aws>`_
+`MONGODB-AWS <https://www.mongodb.com/docs/languages/python/pymongo-driver/current/security/authentication/aws-iam/#std-label-pymongo-mongodb-aws>`_
 authentication requires ``aws`` extra dependency::
 
   $ pip install "motor[aws]"
diff --git a/doc/migrate-to-motor-3.rst b/doc/migrate-to-motor-3.rst
index bd64fbb5..f4930467 100644
--- a/doc/migrate-to-motor-3.rst
+++ b/doc/migrate-to-motor-3.rst
@@ -460,7 +460,6 @@ The default uuid_representation for :class:`~bson.codec_options.CodecOptions`,
 :data:`bson.binary.UuidRepresentation.PYTHON_LEGACY` to
 :data:`bson.binary.UuidRepresentation.UNSPECIFIED`. Attempting to encode a
 :class:`uuid.UUID` instance to BSON or JSON now produces an error by default.
-See :ref:`handling-uuid-data-example` for details.
 
 
 Upgrade to Motor 3.0
diff --git a/motor/docstrings.py b/motor/docstrings.py
index eaf0b670..66ee4fda 100644
--- a/motor/docstrings.py
+++ b/motor/docstrings.py
@@ -187,7 +187,7 @@ This will print something like::
 :Returns:
   An instance of :class:`~pymongo.results.BulkWriteResult`.
 
-.. seealso:: :ref:`writes-and-ids`
+.. seealso:: `Writes and ids <https://www.mongodb.com/docs/languages/python/pymongo-driver/current/crud/insert/#overview>`_
 
 .. note:: `bypass_document_validation` requires server version
   **>= 3.2**
@@ -829,7 +829,7 @@ This prints something like::
 :Returns:
   An instance of :class:`~pymongo.results.InsertManyResult`.
 
-.. seealso:: :ref:`writes-and-ids`
+.. seealso:: `Writes and ids <https://www.mongodb.com/docs/languages/python/pymongo-driver/current/crud/insert/#overview>`_
 
 .. note:: `bypass_document_validation` requires server version
   **>= 3.2**
@@ -866,7 +866,7 @@ This code outputs the new document's ``_id``::
 :Returns:
   - An instance of :class:`~pymongo.results.InsertOneResult`.
 
-.. seealso:: :ref:`writes-and-ids`
+.. seealso:: `Writes and ids <https://www.mongodb.com/docs/languages/python/pymongo-driver/current/crud/insert/#overview>`_
 
 .. note:: `bypass_document_validation` requires server version
   **>= 3.2**