031324: fix link (#529)

* 031324: fix link

(cherry picked from commit b4dba6d)

Author: Chris Cho

source/connection-troubleshooting.txt

@@ -68,6 +68,8 @@ Connection Troubleshooting
          For more information about using connection strings,
          see :ref:`Connection URI <connection-uri>` in the Connection Guide.
 
+   .. replacement:: percent-encode-example
+
    .. replacement:: verify-authentication-database-anchor
 
       .. _java-verify-auth-db:

source/upgrade.txt

@@ -64,7 +64,7 @@ Version 5.0 Breaking Changes
 This driver version introduces the following breaking changes:
 
 - Introduces the following changes to the ``ConnectionId`` class:
-  
+
   - The ``ConnectionId`` constructor now accepts a value of type ``long`` as its second
     parameter instead of type ``int``. Similarly, the constructor now accepts a value of
     type ``Long`` as its third parameter instead of type ``Integer``. Because this change breaks
@@ -92,7 +92,7 @@ This driver version introduces the following breaking changes:
   ``SocketSettings.Builder.connectTimeout()`` and
   ``SocketSettings.Builder.readTimeout()`` methods. The data type of this
   parameter is now ``long`` instead of ``int``.
-  
+
   In earlier versions, this parameter is of type ``int`` for both methods. This
   change breaks binary compatibility and requires recompiling, but does not
   require code changes. To view an example that shows how to call
@@ -118,8 +118,8 @@ This driver version introduces the following breaking changes:
   API also exposes ``org.mongodb.scala.Observable[Unit]`` instead of
   ``org.mongodb.scala.Observable[Void]``.
 
-  .. After the 5.0 Scala API docs are released, this line will be uncommented.
-    For more information, see the `Observable trait documentation <https://mongodb.github.io/mongo-java-driver/5.0/apidocs/mongo-scala-driver/org/mongodb/scala/Observable.html>`__.
+  For more information, see the `Observable trait in the Scala API documentation
+  <https://mongodb.github.io/mongo-java-driver/5.0/apidocs/mongo-scala-driver/org/mongodb/scala/Observable.html>`__.
 
 - Changes how ``ClusterSettings`` computes
   ``ClusterConnectionMode``, making it more consistent by using the specified
@@ -151,7 +151,7 @@ This driver version introduces the following breaking changes:
   responding in the same way as ``Decimal128`` values. In particular,
   ``BsonDecimal128.isNumber()`` now returns ``true``, and
   ``BsonDecimal128.asNumber()`` returns the equivalent ``BsonNumber``.
-  
+
 - Removes the `ServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/ServerAddress.html>`__
   methods ``getSocketAddress()`` and ``getSocketAddresses()``.
 
@@ -184,12 +184,12 @@ This driver version introduces the following breaking changes:
 - Removes the ``DBCollection.getStats()`` and ``DBCollection.isCapped()``
   helper methods for the ``collStats`` command. Instead of these methods, you can use the
   ``$collStats`` aggregation pipeline stage. For an example of how to use this pipeline
-  stage, see :manual:`What's New <java-deprecations-4.11>` for v4.11 of the {+driver-short+}.
+  stage, see :ref:`<version-4.11>` for the {+driver-short+}.
 
 - Removes the ``MapCodec`` and ``IterableCodec`` classes.
   Instead of ``MapCodec``, use ``MapCodecProvider``. Instead of ``IterableCodec``,
   use ``CollectionCodecProvider``, or ``IterableCodecProvider`` for ``Iterable``
-  types that aren't ``Collection`` types.  
+  types that aren't ``Collection`` types.
 
 - Removes the ``sharded()`` and ``nonAtomic()`` methods from the
   ``MapReducePublisher`` and ``MapReduceIterable`` classes.
@@ -199,7 +199,7 @@ This driver version introduces the following breaking changes:
   - ``Indexes.geoHaystack()``
   - ``IndexOptions.getBucketSize()``
   - ``IndexOptions.bucketSize()``
-  
+
   Instead, you can use the ``$geoNear`` aggregation pipeline stage or a geospatial
   query operator on a 2d index. For more information, see the
   :manual:`Geospatial Queries page </geospatial-queries>` in the {+mdb-server+} manual.
@@ -262,7 +262,7 @@ This driver version introduces the following breaking changes:
 
 - Removes the following classes from the
   ``com.mongodb.event`` package:
-  
+
   - ``ConnectionAddedEvent``
   - ``ConnectionPoolOpenedEvent``
   - ``ConnectionRemovedEvent``
@@ -273,11 +273,11 @@ This driver version introduces the following breaking changes:
 
   Because of these removals, the following methods were also removed from the
   ``ConnectionPoolListener`` interface:
-  
+
   - ``connectionAdded``
   - ``connectionPoolOpened``
   - ``connectionRemoved``
-  
+
   For more information about the events package, see the `com.mongodb.event
   package documentation <{+api+}/apidocs/mongodb-driver-core/com/mongodb/event/package-summary.html>`__
 
@@ -288,7 +288,7 @@ This driver version introduces the following breaking changes:
   change in the ``MongoDatabase.listCollectionNames()`` methods, meaning any
   code using these methods must be recompiled. This change does not require any
   changes to source code.
-  
+
 - Removes the following methods and types related to the
   `Stream
   <https://mongodb.github.io/mongo-java-driver/4.11/apidocs/mongodb-driver-core/com/mongodb/connection/Stream.html>`__