DOCS-487 updated Administration sign-post

Author: Bob Grabar

source/administration.txt

@@ -2,44 +2,52 @@
 Administration
 ==============
 
-Core Competencies
------------------
+This page lists the core administrative documentation, including
+administration tutorials. This page also provides links to
+administrative documentation for replica sets, sharding, and indexes.
+
+Core Documentation
+------------------
+
+The following is the expanded outline of the core administration
+documentation:
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
 
-   administration/backups
-   administration/import-export
-   administration/monitoring
    administration/configuration
    administration/ssl
+   administration/monitoring
+   administration/import-export
+   administration/backups
 
-.. seealso:: For more information regarding :term:`replica set`
-   administration, consider: 
+.. seealso::
 
    - :doc:`/administration/replica-sets`
    - :doc:`/administration/replication-architectures`
-
-   For more information regarding :term:`shard cluster`
-   administration: consider: 
-
    - :doc:`/administration/sharding`
    - :doc:`/administration/sharding-architectures`
+   - :doc:`indexes </core/indexes>`
+   - :doc:`/administration/indexes`
 
-   For information regarding administrative concerns related to
-   :doc:`indexes </core/indexes>`, see ":doc:`/administration/indexes`."
-   
+.. index:: tutorials; administration
 .. _administration-tutorials:
 
 Tutorials
 ---------
 
+The following tutorials describe core administrative procedures:
+
 .. toctree::
    :hidden:
 
    tutorial/recover-data-following-unexpected-shutdown
    tutorial/convert-replica-set-to-replicated-shard-cluster
 
+.. TODO: Is there a way to replace this list below with the list in
+.. /source/tutorial#tutorials-administration
+.. That way, we'd have just one list to keep updated. -bg
+
 - :doc:`/tutorial/expire-data`
 - :doc:`/tutorial/deploy-replica-set`
 - :doc:`/tutorial/expand-replica-set`
@@ -55,4 +63,3 @@ Tutorials
 - :doc:`/tutorial/convert-replica-set-to-replicated-shard-cluster`
 - :doc:`/tutorial/add-shards-to-shard-cluster`
 - :doc:`/tutorial/remove-shards-from-cluster`
-

source/replication.txt

@@ -12,8 +12,8 @@ For an overview, see :doc:`/core/replication`. To work with members, see
 :doc:`administration/replica-sets`. To configure deployment
 architecture, see :doc:`administration/replication-architectures`. To
 modify read and write operations, see :doc:`applications/replication`.
-For common procedures, see the :ref:`tutorials list
-<replica-set-tutorials-list>`.
+For common procedures, see the :ref:`Tutorials
+<replica-set-tutorials-list>` list.
 
 Documentation
 -------------

source/sharding.txt

@@ -20,10 +20,10 @@ describe sharding.
 For an overview, see :doc:`/core/sharding`. To configure, maintain, and
 troubleshoot shard clusters, see :doc:`/administration/sharding`. For
 deployment architectures, see
-:doc:`/administration/sharding-architectures` For details on the
+:doc:`/administration/sharding-architectures`. For details on the
 internal operations of sharding, see :doc:`/core/sharding-internals`.
-For common procedures, see the :ref:`tutorials list
-<sharding-tutorials>`.
+For common procedures, see the :ref:`Tutorials <sharding-tutorials>`
+list.
 
 Documentation
 -------------
@@ -44,8 +44,7 @@ The following is the expanded outline of the main documentation:
 Tutorials
 ---------
 
-The following tutorials describe basic administrative procedures for
-deploying and managing shard clusters:
+The following tutorials describe basic administrative procedures:
 
 .. toctree::
    :maxdepth: 1
@@ -67,7 +66,7 @@ development pattern:
 Reference
 ---------
 
-The following describes sharding commands:
+The following reference section describes sharding commands:
 
 - :ref:`sharding-commands`