(DOCSP-26780): Make reference a landing page and alphabetize subpages (#2371)

* (DOCSP-26780): Make reference a landing page and alphabetize subpages

* (DOCSP-26760): improvements

* fix refs

Author: jeff-allen-mongo

snooty.toml

@@ -102,6 +102,7 @@ toc_landing_pages = [
    "/indexes",
    "/introduction",
    "/mongo",
+   "/reference",
    "/reference/aggregation",
    "/reference/bson-types",
    "/reference/change-events",

source/reference.txt

@@ -12,112 +12,115 @@ Reference
    :depth: 1
    :class: singlecol
 
-:doc:`/reference/operator`
-   Documentation of query, update, projection, and aggregation
-   framework operators.
+:ref:`collation`
+   Description of collation fields as well as supported languages and
+   associated locales for collation.
+
+:ref:`configuration-options`
+   Full documentation of the configuration file and available
+   run-time operations.
+
+:ref:`mongodb-uri`
+   The complete specification of the MongoDB connection string format
+   that the drivers use to describe connections to MongoDB
+   deployments.
 
-:doc:`/reference/command`
+:ref:`database-commands`
    Documentation of all MongoDB :term:`database commands <database
    command>` operations, syntax, and use.
 
-:doc:`/reference/method`
-   Documentation of JavaScript methods and helpers in
-   :binary:`~bin.mongosh`.
+:ref:`default-mongodb-port`
+   List of default ports used by MongoDB.
 
-:doc:`/reference/mongo`
-   Documentation of JavaScript methods and helpers in
-   the legacy :binary:`~bin.mongo` shell.
+:ref:`default-mongodb-read-write-concerns`
+   List of default read and write concerns.
 
-:doc:`/reference/program`
-   Documentation of :binary:`~bin.mongod` and :binary:`~bin.mongos`
-   and all other tools distributed with MongoDB.
+:ref:`server-exit-codes`
+   Details the codes and statuses that MongoDB returns when exiting.
 
-:doc:`/reference/configuration-options`
-   Full documentation of the configuration file and available
-   run-time operations.
+:ref:`explain-results`
+   Documentation on information returned from explain operations.
 
-:doc:`/reference/parameters`
-   Documentation of all :binary:`~bin.mongod` and
-   :binary:`~bin.mongos` parameters that are available in the
-   :dbcommand:`setParameter` (command) and :setting:`setParameter`
-   run-time interface.
+:ref:`glossary`
+   A glossary of common terms and concepts specific to MongoDB.
+
+:ref:`log-messages-ref`
+   Describes the components of log messages.
 
-:doc:`/reference/cluster-parameters`
+:ref:`cluster-parameters`
    Documentation of all :binary:`~bin.mongod` and
    :binary:`~bin.mongos` parameters that are available in the
    :dbcommand:`setClusterParameter`.
 
-:doc:`/reference/limits`
+:ref:`server-limits-thresholds`
    A list of important limits and thresholds imposed by MongoDB.
 
-:doc:`/reference/explain-results`
-   Documentation on information returned from explain operations.
-
-:doc:`/reference/system-collections`
-   Describes the collections that MongoDB reserves for internal use.
-
-:doc:`/reference/connection-string`
-   The complete specification of the MongoDB connection string format
-   that the drivers use to describe connections to MongoDB
-   deployments.
+:ref:`mongodb-package-components`
+   Documentation of :binary:`~bin.mongod` and :binary:`~bin.mongos`
+   and all other tools distributed with MongoDB.
 
-:doc:`/reference/collation`
-   Description of collation fields as well as supported languages and
-   associated locales for collation.
+:ref:`server-parameters`
+   Documentation of all :binary:`~bin.mongod` and
+   :binary:`~bin.mongos` parameters that are available in the
+   :dbcommand:`setParameter` (command) and :setting:`setParameter`
+   run-time interface.
 
-:doc:`/reference/mongodb-wire-protocol`
+:ref:`mongodb-wire-protocol`
    Description of the MongoDB Wire Protocol.
 
-:doc:`/reference/log-messages`
-   Describes the components of log messages.
-
-:doc:`/reference/exit-codes`
-   Details the codes and statuses that MongoDB returns when exiting.
 
-:doc:`/reference/glossary`
-   A glossary of common terms and concepts specific to MongoDB.
+:ref:`js-administrative-methods`
+   Documentation of JavaScript methods and helpers in
+   :binary:`~bin.mongosh`.
 
-:doc:`/reference/default-mongodb-port`
-   List of default ports used by MongoDB.
+:ref:`operator-ref-landing`
+   Documentation of query, update, projection, and aggregation
+   framework operators.
 
-:doc:`/reference/mongodb-defaults`
-   List of default read and write concerns.
+:ref:`stable-api`
+   Describes the Stable API.
 
-:doc:`/reference/server-sessions`
+:ref:`server-sessions`
    Describes server sessions.
 
-:doc:`/reference/stable-api`
-   Describes the Stable API.
+:ref:`metadata-system-collections`
+   Describes the collections that MongoDB reserves for internal use.
+
+:ref:`mongo`
+   Documentation of JavaScript methods and helpers in
+   the legacy :binary:`~bin.mongo` shell.
 
 .. seealso::
 
-   The
-   :doc:`/reference/data-models`, :doc:`/reference/sharding`,
-   :doc:`/reference/replication`, and :doc:`/reference/security`
-   contain additional reference material.
+   The following pages contain additional reference material:
+
+   - :ref:`data-modeling-patterns`
+   - :ref:`sharding-reference`
+   - :ref:`replication-toc`
+   - :ref:`security-reference`
 
 .. toctree::
    :titlesonly: 
    :hidden: 
 
-   /reference/operator
-   /reference/command
-   /reference/method
-   /reference/mongo
-   /reference/program
+   /reference/collation
    /reference/configuration-options
-   /reference/parameters
-   /reference/cluster-parameters
-   /reference/limits
-   /reference/explain-results
-   /reference/system-collections
    /reference/connection-string
-   /reference/collation
-   /reference/mongodb-wire-protocol
-   /reference/log-messages
-   /reference/exit-codes
-   /reference/glossary
+   /reference/command
    /reference/default-mongodb-port
    /reference/mongodb-defaults
-   /reference/server-sessions
+   /reference/exit-codes
+   /reference/explain-results
+   /reference/glossary
+   /reference/log-messages
+   /reference/cluster-parameters
+   /reference/limits
+   /reference/program
+   /reference/parameters
+   /reference/mongodb-wire-protocol
+   /reference/method
+   /reference/operator
    /reference/stable-api
+   /reference/server-sessions
+   /reference/system-collections
+   /reference/mongo

source/reference/default-mongodb-port.txt

@@ -1,3 +1,5 @@
+.. _default-mongodb-port:
+
 ====================
 Default MongoDB Port
 ====================
@@ -44,4 +46,4 @@ The following table lists the default TCP ports used by MongoDB:
        messages. ``mongocryptd`` is installed with `MongoDB Enterprise 
        Server (version 4.2 and later) 
        <https://www.mongodb.com/download-center/enterprise>`__ and 
-       supports automatic encryption operations.
+       supports automatic encryption operations.

source/reference/exit-codes.txt

@@ -1,3 +1,5 @@
+.. _server-exit-codes:
+
 =======================
 Exit Codes and Statuses
 =======================

source/reference/limits.txt

@@ -1,3 +1,5 @@
+.. _server-limits-thresholds:
+
 =============================
 MongoDB Limits and Thresholds
 =============================

source/reference/parameters.txt

@@ -1,3 +1,5 @@
+.. _server-parameters:
+
 =========================
 MongoDB Server Parameters
 =========================

source/reference/program.txt

@@ -1,3 +1,5 @@
+.. _mongodb-package-components:
+
 ==========================
 MongoDB Package Components
 ==========================

source/reference/security.txt

@@ -1,3 +1,5 @@
+.. _security-reference:
+
 ==================
 Security Reference
 ==================
@@ -178,4 +180,3 @@ Security Reference Documentation
    /reference/system-users-collection
    /reference/resource-document
    /reference/privilege-actions
-

source/reference/server-sessions.txt

@@ -1,3 +1,5 @@
+.. _server-sessions:
+
 ===============
 Server Sessions
 ===============

source/reference/sharding.txt

@@ -1,3 +1,5 @@
+.. _sharding-reference:
+
 ==================
 Sharding Reference
 ==================