DOCS-290 a couple of improvements to release notes

source/release-notes/2.2.txt

@@ -109,10 +109,12 @@ Documentation: :doc:`/applications/aggregation`
 
 Reference: :doc:`/reference/aggregation`
 
+Examples: :doc:`/tutorial/aggregation-examples`
+
 TTL Collections
 ```````````````
 
-Documentation: :doc:`/tutorial/expire-data`.
+Documentation: :doc:`/tutorial/expire-data`
 
 Concurrency Improvements
 ````````````````````````
@@ -124,24 +126,26 @@ Issues:
 
 .. TODO mention server stats reporting here. currentOp, serverStatus, profile.
 
-Documentation: Updated reporting on :ref:`locks` in :doc:`server status </reference/server-status>`.
-
-
-
-Query Optimizer Improvements
-````````````````````````````
+Documentation: Updated reporting on :ref:`locks` in :doc:`server
+status </reference/server-status>` as well as :doc:`mongotop
+</reference/mongotop>` and :doc:`mongostat </reference/mongostat>`.
 
-:issue:`SERVER-4148`
-:issue:`SERVER-4149`
+.. TODO add links to current op when it happens.
 
 Tag Aware Sharding
 ``````````````````
 
 :wiki:`Documentation <Tag+Aware+Sharding>`
 
+.. TODO see kristina's blog post.
 
-``mongos`` Supports Read Preference Semantics
-`````````````````````````````````````````````
+Fully Supported Read Preference Semantics
+`````````````````````````````````````````
+
+.. TODO write blurb mentioning mongos.
+
+   mongos and all major drivers support full read preference as
+   specified:
 
 :ref:`replica-set-read-preference`
 
@@ -294,8 +298,8 @@ Windows Support for ``edit`` Command
 
 :issue:`SERVER-4200`
 
-Helper to load Server-Side Functions in the Shell
-`````````````````````````````````````````````````
+Helper to load Server-Side Functions
+````````````````````````````````````
 
 :issue:`SERVER-1651`
 
@@ -304,81 +308,63 @@ Support for Bulk Inserts
 
 :issue:`SERVER-3819`
 
-Start Up and Operations
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Process ID ("PID") added to ``serverStatus`` Output
-```````````````````````````````````````````````````
-
-:issue:`SERVER-4735`
+Operations
+~~~~~~~~~~
 
 Support for logging to Syslog
 `````````````````````````````
 
 :issue:`SERVER-2957`
 
-Reduce Config Server File Size Requirements
-```````````````````````````````````````````
+Improved Authentication Support
+```````````````````````````````
 
-:issue:`SERVER-4297`
+``touch`` Command
+`````````````````
 
-Abort Start Process if there is Insufficient Space for Journal files
-````````````````````````````````````````````````````````````````````
+Added the :dbcommand:`touch` command to read the data and/or indexes
+from a collection into memory.
 
-:issue:`SERVER-4139`
+See: :issue:`SERVER-2023` and :dbcommand:`touch` for more information.
 
-Improved Authentication Support
-```````````````````````````````
+Padding Specifiable on ``compact`` Command
+``````````````````````````````````````````
 
-Better Concurrency with OpenSSL
-```````````````````````````````
+:issue:`SERVER-4018`
 
-:issue:`SERVER-4749`
+.. TODO fix documentation and link
 
 Replication
 ~~~~~~~~~~~
 
-Members Removed from Replica Sets Close Connections
-```````````````````````````````````````````````````
-
-:issue:`SERVER-4501`
-
 Replica Set Members will not Sync from Members Without Indexes Unless ``buildIndexes: false``
 `````````````````````````````````````````````````````````````````````````````````````````````
 
 :issue:`SERVER-4160`
 
-Better Visibility into Stuck Replication Condition
-``````````````````````````````````````````````````
+Improved Logging for Replica Set Lag
+````````````````````````````````````
 
 :issue:`SERVER-3575`
 
+.. TODO add replset sync from :dbcommand:`replSetSyncFrom` :func:`rs.syncFrom()`
+
 Map Reduce
 ~~~~~~~~~~
 
+Improved Support for Sharded MapReduce
+``````````````````````````````````````
+
+:issue:`SERVER-4521`
+
 Retry MapReduce Jobs on Config Error
 ````````````````````````````````````
 
 :issue:`SERVER-4158`
 
-MapReduce Improvements for Large Documents
-``````````````````````````````````````````
-
-:issue:`SERVER-4382`
-
-In Sharded Output of MapReduce Operation, Choose Initial Split Points
-`````````````````````````````````````````````````````````````````````
-
-:issue:`SERVER-4521`
-
 Sharding Improvements
 ~~~~~~~~~~~~~~~~~~~~~
 
-Fixed Issue with some Queries against Recently Sharded Collections
-``````````````````````````````````````````````````````````````````
-
-:issue:`SERVER-4171`
-
 Index on Shard Keys Can Now Be a Compound Index
 ```````````````````````````````````````````````
 
@@ -396,50 +382,50 @@ Additional Improvements
 use and state. In previous versions, these data were sampled. See
 :issue:`SERVER-5784` and :status:`indexCounters` for more information.
 
-``_id`` Index not Required for Updates to Capped Collections
-````````````````````````````````````````````````````````````
-
-:issue:`SERVER-4546`
-
-``localTime`` Command
-`````````````````````
-
-:issue:`SERVER-4212`
-
-``touch`` Command
-`````````````````
+``_id`` Indexes on Capped Collections
+`````````````````````````````````````
 
-Added the :dbcommand:`touch` command to read the data and/or indexes
-from a collection into memory.
+All :term:`capped collections <capped collection>` now have an ``_id``
+field by default if they exist outside of the ``local`` database. This
+change only affects capped collections created with 2.2 instances and
+does not impact existing capped collections.
 
-See: :issue:`SERVER-2023` and :dbcommand:`touch` for more information.
+Additionally in :term:`replica sets <replica set>`, :term:`secondaries
+<secondary>` will create indexes on the ``_id`` field for capped
+collections.
 
-Tracking I/O Time and Lock Time in Profiler
-```````````````````````````````````````````
+By requiring an ``_id`` field, and creating ``_id`` indexes on
+secondaries, MongoDB prevents situations where the absence of an
+``_id`` field can cause problems for replication.
 
-:issue:`SERVER-3546`
+See: :issue:`SERVER-5516` for more information.
 
 ``$timestamp`` Extended JSON format
 ```````````````````````````````````
 
 :issue:`SERVER-3483`
 
-Padding Specifiable on Compact Command
-``````````````````````````````````````
-
-:issue:`SERVER-4018`
-
 Added Build Flag to Use System Libraries
 ````````````````````````````````````````
 
-Boost 1.49 Library embedded in codebase.
+The Boost library, version 1.49, is now embeded in the MongoDB
+code base.
+
+.. TODO help the verbs
 
 Additionally, added a flag to ``scons`` so that the build process can
-use system libraries.
+use system libraries, if desired. To build MongoDB with system
+libraries for all libraries, use the following arguments to ``scons``:
+
+.. code-block:: sh
+
+   scons --use-system-all
 
-:issue:`SERVER-3829`
+You can use the ``--use-system-boost`` to only use the system Boost
+library.
 
-:issue:`SERVER-5172`
+See the :issue:`SERVER-3829` and :issue:`SERVER-5172` issues for more
+information.
 
 Resources
 ---------