Sharding reference: update per review

Author: andreyaksenov

doc/reference/configuration/configuration_reference.rst

@@ -2398,15 +2398,14 @@ The ``security`` section defines configuration parameters related to various sec
 sharding
 --------
 
-The ``sharding`` section defines configuration parameters related to sharding.
+The ``sharding`` section defines configuration parameters related to :ref:`sharding <vshard-admin>`.
 
 ..  NOTE::
 
     Sharding support requires installing the :ref:`vshard <vshard>` module.
     The minimum required version of ``vshard`` is 0.1.25.
 
 -   :ref:`sharding.bucket_count <configuration_reference_sharding_bucket_count>`
--   :ref:`sharding.connection_outdate_delay <configuration_reference_sharding_connection_outdate_delay>`
 -   :ref:`sharding.discovery_mode <configuration_reference_sharding_discovery_mode>`
 -   :ref:`sharding.failover_ping_timeout <configuration_reference_sharding_failover_ping_timeout>`
 -   :ref:`sharding.lock <configuration_reference_sharding_lock>`
@@ -2453,21 +2452,21 @@ The ``sharding`` section defines configuration parameters related to sharding.
     | Default: 3000
     | Environment variable: TT_SHARDING_BUCKET_COUNT
 
+.. TODO: Remove: for internal use
+    ..  _configuration_reference_sharding_connection_outdate_delay:
 
-..  _configuration_reference_sharding_connection_outdate_delay:
+    ..  confval:: sharding.connection_outdate_delay
 
-..  confval:: sharding.connection_outdate_delay
+        The delay (in seconds) to outdate old replica set and replica objects after reconfiguration.
 
-    The delay (in seconds) to outdate old replica set and replica objects after reconfiguration.
-
-    ..  NOTE::
+        ..  NOTE::
 
-        This option should be defined at the :ref:`global level <configuration_scopes>`.
+            This option should be defined at the :ref:`global level <configuration_scopes>`.
 
-    |
-    | Type: number
-    | Default: nil
-    | Environment variable: TT_SHARDING_CONNECTION_OUTDATE_DELAY
+        |
+        | Type: number
+        | Default: nil
+        | Environment variable: TT_SHARDING_CONNECTION_OUTDATE_DELAY
 
 
 ..  _configuration_reference_sharding_discovery_mode:
@@ -2514,7 +2513,7 @@ The ``sharding`` section defines configuration parameters related to sharding.
 
     ..  NOTE::
 
-        This option should be defined at the :ref:`replica set level <configuration_scopes>`.
+        ``sharding.lock`` can be specified at the :ref:`replica set level <configuration_scopes>` or higher.
 
     |
     | Type: boolean
@@ -2621,7 +2620,7 @@ The ``sharding`` section defines configuration parameters related to sharding.
     If it is not specified, a rebalancer is selected automatically from master instances of replica sets.
 
     There can be at most one replica set with the ``rebalancer`` role.
-    Additionally, this replica set should have a storage role.
+    Additionally, this replica set should have a ``storage`` role.
 
     **Example:**
 
@@ -2730,7 +2729,7 @@ The ``sharding`` section defines configuration parameters related to sharding.
 
     ..  NOTE::
 
-        This option should be defined at the :ref:`instance level <configuration_scopes>`.
+        ``sharding.zone`` can be specified at any :ref:`level <configuration_scopes>`.
 
     |
     | Type: integer