ux: shortening the index page

Author: Sam Kleinman

source/index.txt

@@ -6,44 +6,34 @@ The MongoDB Manual
 
 .. default-domain:: mongodb
 
-Welcome to the MongoDB Manual! This resource starts with the basics of
-MongoDB and goes on to describe the query language, advanced
-clustering configurations, administration, and more.  It also includes
-a thorough glossary and command reference.
+Welcome to the MongoDB Manual! The Manual begins by introducing
+MongoDB continues to describe the query language, operational
+considerations and procedures, administration, among other topics in
+addition to a thorough reference.
 
-This manual is under heavy development, and the ":doc:`/about`" page
-provides links and a more through overview of MongoDB and the Document
-project.
-
-The MongoDB Manual will eventually replace the existing :ref:`MongoDB
-Wiki <mongodb-wiki>`. For the moment, both sets of documentation will
-coexist and link to one another. So, as you explore the manual, you
-may have to move between documentation sites.
+This manual is under constant development, and will soon replace the
+existing :ref:`MongoDB Wiki <mongodb-wiki>`. See the ":doc:`/about`"
+page for an overview of the MongoDB Documentation project.  For now,
+documentation resources coexist and link to one another. As you
+explore the manual, expect to move between documentation sites.
 
 Getting Started
 ---------------
 
 MongoDB is an open-source, document-oriented database designed for
 ease of development and scalability, with particular emphasis on
-Internet applications and infrastructure.  If you're brand new to
-MongoDB, this is the place to start.
+Internet applications and infrastructure.  If you're new to
+MongoDB, begin with the following resources:
 
-1. :doc:`Installing MongoDB <installation>`
-2. :wiki:`The MongoDB Tutorial <Tutorial>`
-3. :doc:`Frequently Asked Questions </faq/fundamentals>`
+- :doc:`Installing MongoDB <installation>`
+- :wiki:`The MongoDB Tutorial <Tutorial>`
+- :doc:`Frequently Asked Questions </faq/fundamentals>`
 
 MongoDB has an :wiki:`active community <community>`. You'll get a
 quick response to any question posted to the `MongoDB User Mailing List`_
 
 .. _`MongoDB User Mailing List`: https://groups.google.com/forum/?fromgroups#!forum/mongodb-user
 
-.. 
-   For Developers
-   --------------
-
-   For Administrators
-   ------------------
-
 MongoDB...
 ----------
 
@@ -110,19 +100,21 @@ MongoDB...
 Reference
 ---------
 
-This manual features a detailed reference, including a glossary of
-terms, a command reference, a query operator reference, and a man page
-for all of the tools bundled with MongoDB.
-
-.. toctree::
-   :maxdepth: 3
+This manual features a detailed reference, including: a JavaScript
+method reference, detailed documentation of all operators in the
+MongoDB query language, manual pages for all MongoDB tools and
+binaries, a reference of all database commands, and full glossary and
+topic index.
 
-   reference
+- :doc:`/reference/javascript`
+- :doc:`/reference/operators`
+- :ref:`MongoDB Manual Pages <man-pages>`
+- :doc:`/reference/commands`
+- :doc:`/reference/glossary`
+- :ref:`MongoDB Manual Topic Index <genindex>`
 
-- :ref:`genindex`
-- :doc:`Outline <contents>`
-- :ref:`search`
-- :doc:`Tutorial Index <tutorial>`
+Also consider the full :doc:`outline of the MongoDB Manual
+<contents>`, and an index of all :doc:`MongoDB tutorials <tutorial>`.
 
 .. _mongodb-wiki:
 
@@ -156,7 +148,6 @@ MongoDB. The following pages from the wiki are especially useful:
         - :wiki:`Collections`
         - :wiki:`Documents`
         - :wiki:`GridFS`
-        - :wiki:`Indexes`
         - :wiki:`Querying`
         - :wiki:`Aggregation`
         - :wiki:`Optimization`
@@ -173,8 +164,6 @@ MongoDB. The following pages from the wiki are especially useful:
        - :wiki:`Components`
        - :wiki:`Journaling`
        - :wiki:`Production Notes <Production+Notes>`
-       - :wiki:`Replication`
-       - :wiki:`Sharding`
        - :wiki:`Monitoring and Diagnostics <Monitoring+and+Diagnostics>`
        - :wiki:`Backups`
        - :wiki:`Durability and Repair <Durability+and+Repair>`

source/reference.txt

@@ -24,6 +24,8 @@ MongoDB Interface
    reference/command
    reference/method
 
+.. _man-pages:
+
 Manual Pages
 ------------