tweak 2.8 relnotes

Author: kay-kim

source/release-notes/2.8-compatibility.rst

@@ -194,7 +194,7 @@ SSL Configuration Option Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 MongoDB 2.8 introduced new :setting:`net.ssl.allowConnectionsWithoutCertificates`
-configuration file and ``--sslAllowConnectionsWithoutCertificates``
+configuration file setting and ``--sslAllowConnectionsWithoutCertificates``
 command line option for :program:`mongod` and :program:`mongos`. These
 options replace previous :setting:`net.ssl.weakCertificateValidation` and
 ``--sslWeakCertificateValidation`` options, which became
@@ -208,9 +208,6 @@ By default, MongoDB instances will *only* start if is certificate
 behavior with the :setting:`net.ssl.allowInvalidCertificates` setting.
 or the ``--sslAllowInvalidCertificates`` command line option.
 
-SSL Certificate Validation
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 SSL Certificate Hostname Validation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -230,16 +227,15 @@ In light of `vulnerabilities in legacy SSL ciphers
 these ciphers have been explicitly disabled in MongoDB. No
 configuration changes are necessary.
 
-Shell: Authentication Compatibility
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``mongo`` Shell Version Compatibility
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Versions of the :program:`mongo` shell before 2.8, are *not*
+Versions of the :program:`mongo` shell before 2.8 are *not*
 compatible with 2.8 deployments of MongoDB that enforce access
 control. If you have a 2.8 MongoDB deployment that requires
-authentication you must use 2.8 versions of the :program:`mongo`
+access control, you must use 2.8 versions of the :program:`mongo`
 shell.
 
-
 Indexes
 -------
 

source/release-notes/2.8-general-improvements.rst

@@ -1,3 +1,5 @@
+.. _2.8-replica-sets:
+
 Replica Sets
 ------------
 
@@ -38,6 +40,8 @@ Other Replica Set Operational Changes
 - For pre-existing collections on secondary members, no longer build
   missing ``_id`` indexes automatically.
 
+.. _2.8-sharded-clusters:
+
 Sharded Clusters
 ----------------
 
@@ -70,8 +74,10 @@ for :dbcommand:`moveChunk` and :dbcommand:`cleanupOrphaned` commands.
 Improvements
 ------------
 
-Logging Improvements
-~~~~~~~~~~~~~~~~~~~~
+.. _2.8-logging-improvements:
+
+Enhanced Logging
+~~~~~~~~~~~~~~~~
 
 To improve usability of the log messages for diagnosis, MongoDB
 categorizes some log messages under specific components, or operations,
@@ -111,6 +117,12 @@ project.
   with the ``--prefix`` option so that you can use custom namespaces
   and store multiple GridFS namespaces in a single database.
 
+Covered Queries
+~~~~~~~~~~~~~~~
+
+For sharded collections, indexes can now cover queries that execute
+against the primary.
+
 Geospatial Enhancement
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -125,13 +137,14 @@ for details.
 Aggregation Enhancement
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-Add new :expression:`$dateToString` operator to facilitate converting a
-date to a formatted string.
+MongoDB 2.8 adds a new :expression:`$dateToString` operator to
+facilitate converting a date to a formatted string.
 
-``$eq`` Enhancement
-~~~~~~~~~~~~~~~~~~~
+``$eq`` Query Operator
+~~~~~~~~~~~~~~~~~~~~~~
 
-:query:`$eq` operator supports queries against sharded collections.
+MongoDB 2.8 adds a :query:`$eq` operator to query for equality
+conditions.
 
 Operational Changes
 -------------------

source/release-notes/2.8.txt

@@ -140,14 +140,16 @@ in development.
 New Query Introspection System
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-MongoDB 2.8 includes a new query introspection system that provides a
-finer-grained introspection into query optimization and query execution
-for :method:`db.collection.count()`, :method:`db.collection.group()`,
-:method:`db.collection.remove()`, :method:`db.collection.update()` and
-:method:`db.collection.find()`. For more information, see
-:method:`db.collection.explain()` method and :dbcommand:`explain`
-command. For information on the format of the new output from explain
-operations, see :doc:`/reference/explain-results`.
+MongoDB 2.8 includes a new query introspection system that provides an
+improved output format and a finer-grained introspection into both
+query plan and query execution.
+
+For details, see the new :method:`db.collection.explain()` method and
+the new :dbcommand:`explain` command as well as the updated
+:method:`cursor.explain()` method.
+
+For information on the format of the new output, see
+:doc:`/reference/explain-results`.
 
 Security Improvements
 ---------------------
@@ -163,24 +165,33 @@ Changes to the Localhost Exception
 When using :ref:`localhost-exception` to access MongoDB, you have limited
 access and can only create a user in the ``admin`` database.
 
-Query Engine Improvements
--------------------------
-
-Covered Queries
-~~~~~~~~~~~~~~~
-
-For sharded collections, indexes can now cover queries that execute against the
-primary.
-
 Additional Changes
-----------------------
+------------------
+
+General Improvements
+~~~~~~~~~~~~~~~~~~~~
 
 .. class:: hidden
 
    .. toctree::
 
       /release-notes/2.8-general-improvements
 
+MongoDB 2.8 introduces numerous enhancements, such as:
+
+- Changes to the step down behavior for replica sets;
+
+- More efficient index builds during initial sync;
+
+- Configurable write concern for chunk migration;
+
+- Enhanced logging; and
+
+- Changes to MongoDB tools.
+
+For details on these and additional improvements, see
+:doc:`/release-notes/2.8-general-improvements`.
+
 Changes Affecting Compatibility
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~