DOCSP-26443 replace docs directives (#2284)

* DOCSP-26443 replace docs directives

* grammar and capitalization fix

Author: lindseymoore

source/administration/production-notes.txt

@@ -234,7 +234,7 @@ other MongoDB components.
    and :doc:`/core/authorization`.
 
 For additional information and considerations on security, refer to the
-documents in the :doc:`Security Section </security>`, specifically:
+documents in the :ref:`Security Section <security>`, specifically:
 
 - :doc:`/administration/security-checklist`
 - :doc:`/core/security-hardening`

source/changeStreams.txt

@@ -32,8 +32,8 @@ transform the notifications at will.
 Availability
 ------------
 
-Change streams are available for :doc:`replica sets <replication>` and
-:doc:`sharded clusters </sharding>`:
+Change streams are available for :ref:`replica sets <replication>` and
+:ref:`sharded clusters <sharding-background>`:
 
 - **Storage Engine.** 
 

source/core/authentication.txt

@@ -50,7 +50,7 @@ MongoDB.
 
 For more information on SCRAM and MongoDB, see:
 
-- :doc:`SCRAM Authentication </core/security-scram>`
+- :ref:`SCRAM Authentication <authentication-scram>`
 - :ref:`scram-client-authentication`
 
 .. _authentication-mechanism-x509:

source/core/index-hashed.txt

@@ -17,7 +17,7 @@ Hashed Indexes
 Hashed indexes maintain entries with hashes of the values of the
 indexed field.
 
-Hashed indexes support :doc:`sharding </sharding>`
+Hashed indexes support :ref:`sharding <sharding-background>`
 using hashed shard keys. :ref:`Hashed based sharding
 <sharding-hashed-sharding>` uses a hashed index of a field as the shard
 key to partition data across your sharded cluster.

source/core/read-preference-use-cases.txt

@@ -84,7 +84,7 @@ reads, because:
   members of the set will need to be able to handle all application
   requests.
 
-:doc:`Sharding </sharding>` increases read and write capacity by
+:ref:`Sharding <sharding-background>` increases read and write capacity by
 distributing read and write operations across a group of machines,
 and is often a better strategy for adding capacity.
 

source/core/workload-isolation.txt

@@ -74,5 +74,5 @@ documentation in the MongoDB Manual:
 
    Before adding workload isolation features to your application
    and MongoDB deployment, become familiar with all documentation of
-   :doc:`replication </replication>`, and :doc:`sharding </sharding>`.
+   :doc:`replication </replication>` and :ref:`sharding <sharding-background>`.
 

source/includes/steps-run-mongodb-on-windows.yaml

@@ -50,7 +50,7 @@ content: |
      b. Click :guilabel:`Allow access`.
 
      To learn more about security and MongoDB, see the
-     :doc:`Security Documentation </security>`.
+     :ref:`Security Documentation <security>`.
 ---
 title: Connect to MongoDB.
 stepnum: 3

source/reference/command/shardCollection.txt

@@ -15,7 +15,7 @@ Definition
 
 .. dbcommand:: shardCollection
 
-   :doc:`Shards </sharding>` a collection to distribute its documents across
+   :ref:`Shards <sharding-background>` a collection to distribute its documents across
    shards. The :dbcommand:`shardCollection` command must be run against the
    ``admin`` database.
 

source/reference/config-database.txt

@@ -14,7 +14,7 @@ Config Database
 
 The collections in the ``config`` database support:
 
-- :doc:`Sharded cluster operations </sharding>`
+- :ref:`Sharded cluster operations <sharding-background>`
 
 - :ref:`Causally consistent sessions <sessions>` for standalones,
   replica sets, and sharded clusters and retryable writes for replica

source/reference/program/mongod.txt

@@ -605,7 +605,7 @@ Core Options
    exist, the localhost interface will continue to have access to the 
    database until you create the first user.
 
-   See :doc:`Security </security>`
+   See :ref:`Security <security>`
    for more information.
 
 

source/tutorial/query-documents.txt

@@ -345,7 +345,7 @@ Read Isolation
 ~~~~~~~~~~~~~~
 
 For reads to :ref:`Replica sets <replication>` and replica set
-:doc:`shards </sharding>`, read concern allows clients to choose a
+:ref:`shards <sharding-background>`, read concern allows clients to choose a
 level of isolation for their reads. For more information, see
 :doc:`/reference/read-concern`.