fix problems

(cherry picked from commit ae06ef9)

Author: rustagir

source/builders/indexes.txt

@@ -27,9 +27,9 @@ following types of indexes:
 - :ref:`Hashed Indexes <index-hashed-indexes>`
 - :ref:`Geospatial Indexes <index-geospatial-indexes>`
 
-Indexes store a subset of the collection’s data set. The index stores
+Indexes store a subset of the collection's data set. The index stores
 the value of a specific field or set of fields, ordered by the value of
-the field. See our guide on :doc:`Indexes </fundamentals/indexes>` for
+the field. See the :ref:`java-fundamentals-indexes` to view
 examples of queries covered by indexes. 
 
 The ``Indexes`` class provides static factory methods for all the MongoDB index types.

source/command.txt

@@ -50,8 +50,6 @@ following:
 
    dbStats: {"db": "sample_mflix", "collections": 5, "views": 0, "objects": 75595, "avgObjSize": 692.1003770090614, "dataSize": 52319328, "storageSize": 29831168, "numExtents": 0, "indexes": 9, "indexSize": 14430208, "fileSize": 0, "nsSizeMB": 0, "ok": 1}
 
-.. include:: /includes/legacy-redirect.rst
-
 For additional information on the classes and methods mentioned on this
 page, see the following resources:
 

source/connection/connect.txt

@@ -34,6 +34,7 @@ Use the ``MongoClients.create()`` method to construct a ``MongoClient``.
    As each ``MongoClient`` represents a thread-safe pool of connections to the
    database, most applications only require a single instance of a
    ``MongoClient``, even across multiple threads. 
+
 All resource usage limits, such as max connections, apply to individual
 ``MongoClient`` instances.
 

source/connection/connection-troubleshooting.txt

@@ -53,6 +53,14 @@ Connection Troubleshooting
 
       .. _java-connection-firewall:
 
+   .. replacement:: connection-pools-learn-more
+
+      .. tip::
+
+         To learn more about connection pools, see 
+         :ref:`mcs-connectionpool-settings` in the Specify MongoClient
+         Settings guide.
+
    .. replacement:: authentication-error-anchor
 
       .. _java-authentication-error:

source/crud/collations.txt

@@ -71,7 +71,7 @@ order as shown below:
 How to Specify Collations
 -------------------------
 
-MongoDB supports collations on most :doc:`CRUD operations </fundamentals/crud>`
+MongoDB supports collations on most :ref:`CRUD operations <java-crud-operations>`
 and aggregations. For a complete list of supported operations, see the
 :manual:`Operations that Support Collations </reference/collation/#operations-that-support-collation>`
 server manual page.

source/crud/read-operations/geo.txt

@@ -229,7 +229,7 @@ Examples
 
 The following examples use the MongoDB Atlas sample dataset. You can learn how
 to  set up your own free-tier Atlas cluster and how to load the sample dataset
-in our :doc:`quick start guide </quick-start>`.
+in :ref:`java-sync-quickstart` tutorial.
 
 The examples use the ``theaters`` collection in the ``sample_mflix`` database
 from the sample dataset. The ``theaters`` collection contains a ``2dsphere`` index

source/crud/read-operations/retrieve.txt

@@ -100,8 +100,8 @@ To perform an aggregate operation, call the ``aggregate()`` method on an
 instance of a ``MongoCollection``. This method accepts aggregation
 expressions to run in sequence. To perform aggregations, you can
 define aggregation stages that specify how to match documents, rename
-fields, and group values. For more information, see our
-:doc:`Aggregation </fundamentals/aggregation>` guide.
+fields, and group values. For more information, see the
+:ref:`java-aggregation` guide.
 
 Example
 ~~~~~~~

source/data-formats/codecs.txt

@@ -35,7 +35,7 @@ sections:
 - :ref:`Custom Codec Example <codecs-custom-example>`
 
 If you are customizing encoding and decoding logic for plain old Java objects
-(POJOs), read our guide on :doc:`POJO Customization </fundamentals/data-formats/pojo-customization>`.
+(POJOs), see the :ref:`fundamentals-pojo-customization` guide.
 
 .. _codecs-codec:
 
@@ -223,9 +223,8 @@ section of this guide.
 
 When working with POJOs, consider using the  ``PojoCodecProvider`` to
 minimize duplicate code to convert commonly-used data types and customize
-their behavior. See our
-:doc:`POJO Customization guide </fundamentals/data-formats/pojo-customization>`
-for more information.
+their behavior. See our :ref:`fundamentals-pojo-customization` guide to
+learn more.
 
 .. _codecs-default-codec-registry:
 

source/data-formats/document-data-format-bson.txt

@@ -47,8 +47,8 @@ including:
 - `JsonObject <{+api+}/apidocs/bson/org/bson/json/JsonObject.html>`__ (BSON library package)
 - `BasicDBObject <{+api+}/apidocs/mongodb-driver-core/com/mongodb/BasicDBObject.html>`__ (Java Driver package)
 
-For more information about using these object types, see our
-:doc:`Documents guide </fundamentals/data-formats/documents>`.
+For more information about using these object types, see the
+:ref:`fundamentals-documents` guide.
 
 .. _install-bson-library:
 

source/data-formats/document-data-format-extended-json.txt

@@ -178,8 +178,8 @@ an example Extended JSON string into a ``Document`` object using the
 
       Document{{_id=507f1f77bcf86cd799439011, myNumber=4794261}}
 
-For more information, see our Fundamentals page
-on :doc:`Documents </fundamentals/data-formats/documents>`.
+For more information, see the :ref:`Documents
+<fundamentals-documents>` guide.
 
 Using the BSON Library
 ~~~~~~~~~~~~~~~~~~~~~~