DOCS-219 indexing stubs and organization

Author: Sam Kleinman

draft/administration/indexing.txt

@@ -0,0 +1,65 @@
+===================
+Indexing Operations
+===================
+
+.. default-domain:: mongodb
+
+Synopsis
+--------
+
+Indexes allow MongoDB to and fulfill queries very efficiently, by
+creating an small and efficient representation of the documents in the
+collection. Fundamentally, indexes in MongoDB operate in a similar
+manner to indexes in other database systems. Read the
+":doc:`/core/indexes`" documentation for more information on the
+fundamentals of indexing in MongoDB, and the
+":doc:`/applications/indexes`" documentation for practical strategies
+and examples for using indexes in your application.
+
+This document, by contrast provides operational guidelines and
+procedures related to indexing data in MongoDB collections.
+
+Operations
+----------
+
+Creating Indexes
+~~~~~~~~~~~~~~~~
+
+:func:`db.collection.ensureIndex()`
+
+Dropping Indexes
+~~~~~~~~~~~~~~~~
+
+:func:`db.collection.dropIndex()`
+
+:func:`db.collection.dropIndexes()`
+
+:dbcommand:`deleteIndexes`
+
+Rebuilding Indexes
+~~~~~~~~~~~~~~~~~~
+
+:func:`db.collection.reIndex()`
+:dbcommand:`reIndex`
+
+Background Index Creation
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Rebuilding Indexes in Replica Sets
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In Version 1.8 and 2.0
+``````````````````````
+
+.. rebuild indexes on secondaries and cycle so that there's never a
+   failover.
+
+In Version 2.2
+``````````````
+
+.. index rebuilds on secondaries are actually background tasks.
+
+Measuring Index Utilization
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. explain, hint, etc.

draft/applications/indexes.txt

@@ -0,0 +1,67 @@
+=============
+Using Indexes
+=============
+
+.. default-domain:: mongodb
+
+Synopsis
+--------
+
+MongoDB supports :doc:`indexes </core/indexes>` that allow the
+database to return results quickly while requiring that the database
+scan a minimal number of documents. This can reduce disk access, and
+help maintain more even performance in general. See the
+":doc:`/core/indexes`" document for more information on the types of
+indexes supported by MongoDB and a general background on the index
+functionality. Also consider the ":doc:`/administration/indexing`"
+document for an introduction to index related operations.
+
+This document provides an overview of the approaches to indexing and
+the strategies that you can use as you develop applications with
+MongoDB.
+
+Strategies
+----------
+
+Use Covered Queries
+~~~~~~~~~~~~~~~~~~~
+
+Sort Using Indexes
+~~~~~~~~~~~~~~~~~~
+
+Store Indexes in RAM
+~~~~~~~~~~~~~~~~~~~~
+
+.. check the size of the index in ram.
+
+   consider the size of the working set.
+
+Considerations
+--------------
+
+Selectivity
+~~~~~~~~~~~
+
+.. ensure the index is selective enough to be able to constrain the
+   match productively.
+
+Insert Throughput
+~~~~~~~~~~~~~~~~~
+
+.. inserts
+
+Storage
+~~~~~~~
+
+.. considerations include:
+   - size of the index
+   - left/right hand hotness
+   - DOCS-224
+
+System
+~~~~~~
+
+.. considerations include:
+   - number of indexs
+   - indexed key limitations
+   - one query per index.

draft/core/indexes.txt

@@ -10,9 +10,10 @@ Synopsis
 Indexes are an internal representation of the documents in your
 database organized so that MongoDB can use them to quickly locate
 documents and fulfill queries very efficiently. Fundamentally, indexes
-in MongoDB are similar to indexes, MongoDB supports indexes on any
-field or sub-field contained in documents within a MongoDB
-collection. Consider the following core features of indexes:
+in MongoDB are similar to indexes in other database systems. MongoDB
+supports indexes on any field or sub-field contained in documents
+within a MongoDB collection. Consider the following core features of
+indexes:
 
 - MongoDB defines indexes on a per-collection level.
 
@@ -364,9 +365,24 @@ indexes to fulfill arbitrary queries.
 Geospatial Indexes
 ~~~~~~~~~~~~~~~~~~
 
+.. a brief overview of geo-spatial indexes ~200 words. There should be
+   a more full "/applications/geospatial-indexes" page. That's also
+   (potentially) part of DOCS-219, or we could decide to track this
+   aspect of the documentation separately.
+
 Index Limitations
 -----------------
 
-- Number of indexes.
+..
+   Links to limits sections.
+
+   - Maximum number of indexes.
+
+   - You must have an _id index (except capped collections, unless you
+     replicate the capped collection.)
+
+   - Length of index keys.
+
+   - Impact on insert speed.
 
-- Length of index keys.
+   A minor note about effectiveness of the index relative to its cost.