DOCS-391 migrate 1.8 release notes - draft 3

Author: Bob Grabar

source/release-notes/1.8.txt

@@ -19,12 +19,13 @@ a drop-in replacement for MongoDB 1.6, except:
 - :term:`Replica set <replica set>` members should be upgraded in a
   particular order, as described in :ref:`1.8-upgrade-replica-set`.
 
-- The options for the :wiki:`MapReduce` operation have changed in 1.8,
-  causing incompatibility with previous releases. If you use MapReduce,
-  see the MapReduce
-  :wiki:`Output Options <MapReduce#MapReduce-Outputoptions>`
-  page. If you use MapReduce, this also likely means you need a recent
-  version of your client driver.
+- The :dbcommand:`mapReduce` command has changed in 1.8, causing
+  incompatibility with previous releases. :dbcommand:`mapReduce` no
+  longer generates temporary collections (thus, ``keepTemp`` has been
+  removed). Now, you must always supply a value for ``out``. See the
+  ``out`` field options in the :dbcommand:`mapReduce` document. If you
+  use MapReduce, this also likely means you need a recent version of
+  your client driver.
 
 Preparation
 ~~~~~~~~~~~
@@ -237,24 +238,24 @@ aggregation
 Sparse and Covered Indexes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:wiki:`Sparse Indexes <Indexes#Indexes-sparse%3Atrue>` are indexes that
-only include documents that contain the fields specified in the index.
-Documents missing the field will not appear in the index at all. This
-can significantly reduce index size for attributes that are contained in
-a subset of documents within a :term:`collection`.
+:ref:`Sparse Indexes <sparse-index>` are indexes that only include
+documents that contain the fields specified in the index. Documents
+missing the field will not appear in the index at all. This can
+significantly reduce index size for attributes that are contained in a
+subset of documents within a :term:`collection`.
 
-:wiki:`Covered Indexes <Retrieving+a+Subset+of+Fields#RetrievingaSubsetofFields-CoveredIndexes>`
-enable queries to be answered entirely from the index when the query
-only requests fields that are contained in the index.
+:ref:`Covered Indexes <use-covered-queries>` enable queries to be
+answered entirely from the index when the query only requests fields
+that are contained in the index.
 
 Incremental MapReduce Support
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-MapReduce supports new :wiki:`MapReduce Output Options<MapReduce#MapReduce-Outputoptions>`
-that enable incrementally updating existing :term:`collections
-<collection>`. Previously, a MapReduce job could output either to a
-temporary collection or to a named permanent collection, which it would
-overwrite with new data.
+The :dbcommand:`mapReduce` command supports new options that enable
+incrementally updating existing :term:`collections <collection>`.
+Previously, a MapReduce job could output either to a temporary
+collection or to a named permanent collection, which it would overwrite
+with new data.
 
 You now have several options for the output of your MapReduce jobs:
 
@@ -276,6 +277,9 @@ You now have several options for the output of your MapReduce jobs:
   temporary collections generated in previous releases, except results
   are limited to 8MB.
 
+For more information, see the ``out`` field options in the
+:dbcommand:`mapReduce` document.
+
 Additional Changes and Enhancements
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -314,18 +318,18 @@ Additional Changes and Enhancements
 - :program:`mongos` routes ``slaveOk`` queries to :term:`secondaries
   <secondary>` in :term:`replica sets <replica set>`.
 
-- New :wiki:`MapReduce output options<MapReduce#MapReduce-Outputoptions>`.
+- New :dbcommand:`mapReduce` output options
 
-- :wiki:`Sparse indexes <Indexes#Indexes-sparse%3Atrue>`.
+- :ref:`sparse-index`.
 
 1.7.3
 `````
 
-- :wiki:`Initial covered index support </Retrieving+a+Subset+of+Fields#RetrievingaSubsetofFields-CoveredIndexes>`.
+- Initial :ref:`covered index <use-covered-queries>` support
 
 - Distinct can use data from indexes when possible.
 
-- :wiki:`MapReduce can merge or reduce results into an existing collection </MapReduce#MapReduce-Outputoptions>`.
+- :dbcommand:`mapReduce` can merge or reduce results into an existing collection.
 
 - :program:`mongod` tracks and :program:`mongostat` displays network usage. See :ref:`mongostat`.
 
@@ -336,7 +340,7 @@ Additional Changes and Enhancements
 
 - :operator:`$rename` operator allows renaming of attributes in a document.
 
-- :wiki:`Option to db.eval not to block </Server-side+Code+Execution>`.
+- :method:`db.eval()` not to block.
 
 - Geo queries with sharding.