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
 ~~~~~~~~~~~~~~~~~~~~~~

source/data-formats/documents.txt

@@ -105,8 +105,8 @@ frequently-used BSON and Java types:
 
 The preceding mapping table shows the default mapping when working with the
 ``Document`` class. You can customize the type mapping by specifying a
-custom codec. For more information about customizing mapped types, see our guide
-on using :doc:`Codecs </fundamentals/data-formats/codecs>`.
+custom codec. For more information about customizing mapped types, see the
+:ref:`Codecs <fundamentals-codecs>` guide.
 
 In the following code snippet, we show how to instantiate and build a sample
 ``Document`` instance representing a document containing several
@@ -176,8 +176,8 @@ The output of the preceding code resembles the following:
    title: Chronicle of a Death Foretold, yearPublished: 1981
    title: Love in the Time of Cholera, yearPublished: 1985
 
-For more information about retrieving and manipulating MongoDB data, see our
-:doc:`CRUD guide </fundamentals/crud>`.
+For more information about retrieving and manipulating MongoDB data, see the
+:ref:`java-crud-operations` guides.
 
 For more information about the methods and classes mentioned in this section,
 see the following API Documentation:
@@ -313,13 +313,13 @@ The ``JsonObject`` class acts as a wrapper for JSON strings.
 If you only want to work with JSON data, you can use ``JsonObject``
 to avoid unnecessary data conversion to a ``Map`` object.
 
-By default, ``JsonObject`` stores :manual:`Extended JSON </reference/mongodb-extended-json/>`.
+By default, ``JsonObject`` stores :manual:`Extended JSON
+</reference/mongodb-extended-json/>`.
 You can customize the format of JSON in ``JsonObject`` by specifying a
 ``JsonObjectCodec`` and passing it a ``JsonWriterSettings``
 object. For more information about JSON formats, see
-our :doc:`Extended JSON guide </fundamentals/data-formats/document-data-format-extended-json/>`.
-For more information about specifying codecs, see our
-:doc:`Codecs guide </fundamentals/data-formats/codecs>`.
+the :ref:`java-extended-json` guide. For more information about
+specifying codecs, see the :ref:`fundamentals-codecs` guide.
 
 In the following code snippet, we show how to instantiate a sample ``JsonObject``
 instance wrapping an Extended JSON string containing different types of key value pairs:

source/data-formats/pojo-customization.txt

@@ -14,8 +14,8 @@ Overview
 --------
 
 In this guide, you can learn how to define custom data conversions between
-BSON and POJOs in the MongoDB Java driver. In our guide on :doc:`POJOs </fundamentals/data-formats/document-data-format-pojo>`,
-we show how to specify a ``PojoCodecProvider`` which contains classes that
+BSON and POJOs in the MongoDB Java driver. The :ref:`fundamentals-pojos`
+guide demonstrates how to specify a ``PojoCodecProvider`` which contains classes that
 provide instructions on how to convert data for one or more POJO classes
 and their properties.
 
@@ -35,7 +35,7 @@ enums, generics, interface types, or abstract types, see the section on
 
 If you are using only the predefined behavior to convert data between
 BSON and POJOs, you can use the **automatic** setting for the
-``PojoCodecProvider`` shown in the :doc:`Document Data Formats: POJOs guide </fundamentals/data-formats/document-data-format-pojo>`.
+``PojoCodecProvider`` shown in the :ref:`fundamentals-pojos` guide.
 
 Customize a PojoCodecProvider
 -----------------------------