Updated reference documentation in preparation for the 3.1 release.

Author: jyemin

docs/reference/content/bson/installation-guide.md

@@ -22,4 +22,4 @@ This library comprehensively supports [BSON](http://www.bsonspec.org),
 the data storage and network transfer format that MongoDB uses for "documents".
 BSON is short for Binary [JSON](http://json.org/), is a binary-encoded serialization of JSON-like documents.
 
-{{< install artifactId="bson" version="3.1.0-SNAPSHOT" >}}
+{{< install artifactId="bson" version="3.1.0-rc0" >}}

docs/reference/content/driver-async/getting-started/quick-tour-admin.md

@@ -223,7 +223,8 @@ For more information about text search see the [text index]({{< docsref "/core/i
 ## Running a command
 
 While not all commands have a specific helper, however you can run any [command]({{< docsref "/reference/command">}})
-by using the [`runCommand()`](http://api.mongodb.org/java/3.0/?com/mongodb/async/client/MongoDatabase.html#runCommand-org.bson.conversions.Bson-com.mongodb.ReadPreference-com.mongodb.async.SingleResultCallback-) method.  Here we call the [buildInfo]({{ docsref "reference/command/buildInfo" }}) command:
+by using the [`runCommand()`](http://api.mongodb.org/java/3.1/?com/mongodb/async/client/MongoDatabase.html#runCommand-org.bson.conversions.Bson-com.mongodb.ReadPreference-com.mongodb.async.SingleResultCallback-) 
+method.  Here we call the [buildInfo]({{ docsref "reference/command/buildInfo" }}) command:
 
 ```java
 database.runCommand(new Document("buildInfo", 1), new SingleResultCallback<Document>() {

docs/reference/content/driver-async/reference/index.md

@@ -11,7 +11,7 @@ title = "Reference"
 ## Reference
 
 The reference documentation for the Java driver focuses on high-level documentation and use-cases. The Javadoc-generated API reference is
-[here](http://api.mongodb.org/java/3.0/).    
+[here](http://api.mongodb.org/java/3.1/).    
 
 - [Connecting]({{< relref "driver-async/reference/connecting/index.md" >}}): Documentation of the driver's support for connecting to MongoDB servers
 - [CRUD]({{< relref "driver-async/reference/crud/index.md" >}}): Documentation of the driver's support for CRUD operations

docs/reference/content/driver-async/reference/management/monitoring.md

@@ -15,7 +15,7 @@ The driver uses [JMX](http://docs.oracle.com/javase/8/docs/technotes/guides/jmx/
 application or end user to monitor various aspects of the driver.
 
 The driver creates MXBean instances of a single type:
-[ConnectionPoolStatisticsMBean](http://api.mongodb.org/java/3.0/com/mongodb/management/ConnectionPoolStatisticsMBean.html).
+[ConnectionPoolStatisticsMBean]({{< apiref "com/mongodb/management/ConnectionPoolStatisticsMBean" >}}).
  The driver registers one `ConnectionPoolStatisticsMBean` instance per each server it connects to. For example, in the case of a replica 
  set, the driver creates an instance per each non-hidden member of the replica set.
 

docs/reference/content/driver/getting-started/quick-tour-admin.md

@@ -166,7 +166,8 @@ For more information about text search see the [text index]({{< docsref "/core/i
 ## Running a command
 
 While not all commands have a specific helper, however you can run any [command]({{< docsref "/reference/command">}})
-by using the [`runCommand()`](http://api.mongodb.org/java/3.0/?com/mongodb/client/MongoDatabase.html#runCommand-org.bson.conversions.Bson-com.mongodb.ReadPreference-) method.  Here we call the [buildInfo]({{ docsref "reference/command/buildInfo" }}) command:
+by using the [`runCommand()`](http://api.mongodb.org/java/3.1/?com/mongodb/client/MongoDatabase.html#runCommand-org.bson.conversions.Bson-com.mongodb.ReadPreference-) 
+method.  Here we call the [buildInfo]({{ docsref "reference/command/buildInfo" }}) command:
 
 ```java
 Document buildInfo = database.runCommand(new Document("buildInfo", 1));

docs/reference/content/driver/reference/index.md

@@ -11,7 +11,7 @@ title = "Reference"
 ## Reference
 
 The reference documentation for the Java driver focuses on high-level documentation and use-cases. The Javadoc-generated API reference is
-[here](http://api.mongodb.org/java/3.0/).    
+[here](http://api.mongodb.org/java/3.1/).    
 
 - [Connecting]({{< relref "driver/reference/connecting/index.md" >}}): Documentation of the driver's support for connecting to MongoDB servers
 - [CRUD]({{< relref "driver/reference/crud/index.md" >}}): Documentation of the driver's support for CRUD operations

docs/reference/content/driver/reference/management/monitoring.md

@@ -15,7 +15,7 @@ The driver uses [JMX](http://docs.oracle.com/javase/8/docs/technotes/guides/jmx/
 application or end user to monitor various aspects of the driver.
 
 The driver creates MXBean instances of a single type:
-[ConnectionPoolStatisticsMBean](http://api.mongodb.org/java/3.0/com/mongodb/management/ConnectionPoolStatisticsMBean.html).
+[ConnectionPoolStatisticsMBean]({{< apiref "com/mongodb/management/ConnectionPoolStatisticsMBean" >}}).
  The driver registers one `ConnectionPoolStatisticsMBean` instance per each server it connects to. For example, in the case of a replica 
  set, the driver creates an instance per each non-hidden member of the replica set.
 

docs/reference/content/index.md

@@ -6,15 +6,16 @@ type = "index"
 
 ## MongoDB Java Driver Documentation
 
-Welcome to the MongoDB Java driver documentation hub for the 3.0 driver release.
+Welcome to the MongoDB Java driver documentation hub for the 3.1 driver release.
 
 
-### What's New in 3.0
+### What's New in 3.1
 
 The [What's New]({{< relref "whats-new/index.md" >}}) guide explains the major new features of the driver. 
 
-If you are upgrading from the 2.x series of the driver, consult the [Upgrading]({{< relref "whats-new/upgrading.md" >}}) documentation for 
-information on breaking changes. 
+If you are upgrading from the 3.0.x series of the driver, consult the [Upgrading]({{< relref "whats-new/upgrading.md" >}}) documentation 
+for information on breaking changes.  If you are upgrading from the 2.x series of the driver, please consult the 3.0 reference 
+documentation as well. 
 
 
 ### MongoDB Driver

docs/reference/content/whats-new/index.md

@@ -7,19 +7,20 @@ title = "What's New"
   pre = "<i class='fa fa-cog'></i>"
 +++
 
-# What's New in 3.0
+# What's New in 3.1
 
-Key features of the 3.0 driver include:
+Key new features of the 3.1 driver include:
 
-- A generic [`MongoCollection`]({{< apiref "com/mongodb/client/MongoCollection" >}}) interface that complies with a new cross-driver 
-[CRUD specification](https://github.com/mongodb/specifications/blob/master/source/crud/crud.rst).
-- A new [asynchronous API](https://github.com/mongodb/mongo-java-driver/tree/master/driver-async) that can leverage either 
-[Netty](http://netty.io/) or Java 7's 
-[AsynchronousSocketChannel](http://docs.oracle .com/javase/7/docs/api/java/nio/channels/AsynchronousSocketChannel.html)
-- A new [Codec]({{< ref "bson/codecs.md" >}}) infrastructure that you can use to build high-performance
- encoders and decoders without requiring an intermediate Map instance.
-- A new core driver on top of which you can build alternative or experimental driver APIs
+- Builder support for [updates]({{< ref "builders/updates.md" >}})
+- Builder support for [aggregation stages and accumulators]({{< ref "builders/aggregation.md" >}})
+- Builder support for [geospatial query filters]({{< ref "builders/filters.md#geospatial" >}})
+- Builder support for [index keys]({{< ref "builders/indexes.md" >}})
+- A new [GridFS API]({{< ref "driver/reference/gridfs/index.md" >}}) that is compatible with the CRUD API introduced in the 3.0 
+driver release 
+(not yet available in the async driver)
+- An [event-based API]({{< ref "driver/reference/management/monitoring.md#command-monitoring" >}}) for monitoring all commands that the 
+driver sends to a MongoDB server and all responses received (not yet available in the async driver)
 
 ## Upgrading
 
-See the [upgrading guide]({{<ref "whats-new/upgrading.md">}}) on how to upgrade to 3.0
+See the [upgrading guide]({{<ref "whats-new/upgrading.md">}}) on how to upgrade to 3.1

docs/reference/content/whats-new/upgrading.md

@@ -1,19 +1,23 @@
 +++
 date = "2015-03-19T12:53:39-04:00"
-title = "Upgrading to 3.0"
+title = "Upgrading to 3.1"
 [menu.main]
   parent = "Whats New"
-  identifier = "Upgrading to 3.0"
+  identifier = "Upgrading to 3.1"
   weight = 40
   pre = "<i class='fa fa-wrench'></i>"
 +++
 
-# Upgrading to 3.0
+# Upgrading from 3.0.x
 
-The 3.0 release is **incompatible** with the 2.x release series. However, where possible, the 2.13.0 driver has deprecated classes or 
-methods that have been removed in 3.0.
+The 3.1 release is binary and source compatible with the 3.0 release, with the following exceptions:
+ 
+- Other than BsonDocument, subclasses of BsonValue no longer implement Serializable
+- BsonDocumentWrapper and RawBsonDocument are now final
 
-Before upgrading to 3.0, compile against 2.13.0 with deprecation warnings enabled and remove use of any deprecated methods or classes.
+# Upgrading from 2.x
+
+Please see the Upgrading guide in the 3.0 driver reference documentation.
 
 ## System Requirements
 
@@ -24,63 +28,3 @@ The minimum JVM is now Java 6: however, specific features require Java 7:
 - The asynchronous API requires Java 7, as by default it relies on
 [`AsynchronousSocketChannel`](http://docs.oracle.com/javase/7/docs/api/java/nio/channels/AsynchronousSocketChannel.html) for
 its implementation.  See [Async]({{< ref "driver-async/index.md" >}}) for details on configuring the driver to use [Netty](http://netty.io/) instead.
-
-## Incompatibilities
-
-The following lists the most significant backwards-breaking changes, along with the recommended solutions.
-
-### General
-
-The driver now enables host name verification by default for SSL connections.  If you are knowingly using an invalid certificate, or are 
-using Java 6 (see above), set the 
-[`sslInvalidHostNameAllowed`](http://api.mongodb.org/java/3.0/com/mongodb/MongoClientOptions.html#isSslInvalidHostNameAllowed--)
-property to true.
-
-### MongoClientOptions
-
-Providing little practical value, 
-the [`autoConnectRetry`](https://api.mongodb.org/java/2.13/com/mongodb/MongoClientOptions .html#isAutoConnectRetry--) and
-[`maxAutoConnectRetryTime`](https://api.mongodb.org/java/2.13/com/mongodb/MongoClientOptions.html#getMaxAutoConnectRetryTime--) 
-properties in
-[`MongoClientOptions`]({{< apiref "com/mongodb/MongoClientOptions" >}}) have been removed from the Java driver to be consistent with other 
-MongoDB-supported drivers .
-
-#### MongoClient
-
-The [`MongoClient`]({{< apiref "com/mongodb/MongoClient" >}}) (and
-[`ServerAddress`]({{< apiref "com/mongodb/ServerAddress" >}})) constructors no longer throw
-[`UnknownHostException`](http://docs.oracle.com/javase/8/docs/api/java/net/UnknownHostException.html): This breaks source but not binary
-compatibility, so re-compilation with 3.0 will only succeed after removing any reference to this exception in catch blocks or method
-throws declarations.
-
-### DB
-
-The [`requestStart`](https://api.mongodb.org/java/2.13/com/mongodb/DB.html#requestStart--) and
-[`requestDone`](https://api.mongodb.org/java/2.13/com/mongodb/DB.html#requestDone--) methods in
-[`DB`]({{< apiref "com/mongodb/DB" >}}) have been removed: These methods have been removed in accordance with the
-[server selection specification](https://github.com/mongodb/specifications/blob/master/source/server-selection/server-selection.rst#what-happened-to-pinning).
-
-The [`authenticate`](https://api.mongodb.org/java/2.13/com/mongodb/DB.html#authenticate-java.lang.String-char:A-) method in
-[`DB`]({{< apiref "com/mongodb/DB" >}}) has been replaced with
-[`MongoClient`](http://api.mongodb.org/java/3.0/com/mongodb/MongoClient.html#MongoClient-java.util.List-java.util.List-) constructors that
-take [`MongoCredential`]({{< apiref "com/mongodb/MongoCredential" >}}) instances.
-
-### DBCollection
-
-The [`ensureIndex`](https://api.mongodb.org/java/2.13/com/mongodb/DBCollection.html#ensureIndex-com.mongodb.DBObject-) methods in
-[`DBCollection`]({{< apiref "com/mongodb/DBCollection" >}}) have been removed:
-replace with the corresponding
-[`createIndex`](https://api.mongodb.org/java/2.13/com/mongodb/DBCollection.html#createIndex-com.mongodb.DBObject-) method.
-
-### WriteResult
-
-The [`getLastError`](http://api.mongodb.org/java/2.13/com/mongodb/WriteResult.html#getLastError--) method in
-[`WriteResult`]({{< apiref "com/mongodb/WriteResult" >}}) has been removed: this method does not work reliably in
-the 2.x series and there is no way to make work reliably, so it has been removed.  Replace with use of an acknowledged 
-[`WriteConcern`]({{< apiref "com/mongodb/WriteConcern" >}}) when executing the write operation.
-
-### DBRef
-
-The [`fetch`](https://api.mongodb.org/java/2.13/com/mongodb/DBRefBase.html#fetch--) method in
-[`DBRef`]({{< apiref "com/mongodb/DBRef" >}}) has been removed: use the
-[`findOne`](https://api.mongodb.org/java/3.0/com/mongodb/DBCollection.html#findOne-java.lang.Object-) method instead.