Update reference documentation for the 4.2 release (#638)

Author: jyemin

docs/landing/data/releases.toml

@@ -1,12 +1,12 @@
-current = "4.1.1"
+current = "4.2.0"
 
 [[versions]]
-  version = "4.2.0-beta1"
+  status = "current"
+  version = "4.2.0"
   docs = "./4.2"
   api = "./4.2/apidocs"
 
 [[versions]]
-  status = "current"
   version = "4.1.1"
   docs = "./4.1"
   api = "./4.1/apidocs"

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="4.2.0-beta1" >}}
+{{< install artifactId="bson" version="4.2.0" >}}

docs/reference/content/driver-reactive/getting-started/installation.md

@@ -18,4 +18,4 @@ The recommended way to get started using one of the drivers in your project is w
 
 The Reactive Streams implementation for asynchronous stream processing with non-blocking back pressure.
 
-{{< install artifactId="mongodb-driver-reactivestreams" version="4.2.0-beta1">}}
+{{< install artifactId="mongodb-driver-reactivestreams" version="4.2.0">}}

docs/reference/content/driver-scala/getting-started/installation.md

@@ -20,8 +20,8 @@ The Reactive Streams based Scala implementation for asynchronous stream processi
 
 ### Scala 2.12
 
-{{< install artifactId="mongo-scala-driver" version="4.2.0-beta1" groupId="org.mongodb.scala" scalaVersion="2.12">}}
+{{< install artifactId="mongo-scala-driver" version="4.2.0" groupId="org.mongodb.scala" scalaVersion="2.12">}}
 
 ### Scala 2.11
 
-{{< install artifactId="mongo-scala-driver" version="4.2.0-beta1" groupId="org.mongodb.scala" scalaVersion="2.11">}}
+{{< install artifactId="mongo-scala-driver" version="4.2.0" groupId="org.mongodb.scala" scalaVersion="2.11">}}

docs/reference/content/driver/getting-started/installation.md

@@ -31,7 +31,7 @@ The `mongodb-driver-sync` artifact is a valid OSGi bundle whose symbolic name is
 
 {{% /note %}}
 
-{{< install artifactId="mongodb-driver-sync" version="4.2.0-beta1" dependencies="true">}}
+{{< install artifactId="mongodb-driver-sync" version="4.2.0" dependencies="true">}}
 
 ## MongoDB Driver Legacy 
 
@@ -44,4 +44,4 @@ While not deprecated, we recommend that new applications depend on the `mongodb-
 
 {{% /note %}}
 
-{{< install artifactId="mongodb-driver-legacy" version="4.2.0-beta1" dependencies="true">}}
+{{< install artifactId="mongodb-driver-legacy" version="4.2.0" dependencies="true">}}

docs/reference/content/driver/tutorials/jndi.md

@@ -28,7 +28,7 @@ The configuration of the `MongoClientFactory` differs depending on the applicati
 
         <module xmlns="urn:jboss:module:1.3" name="org.mongodb">
            <resources>
-               <resource-root path="mongodb-driver-sync-4.2.0-beta1.jar"/>
+               <resource-root path="mongodb-driver-sync-4.2.0.jar"/>
            </resources>
            <dependencies>
                <module name="javax.api"/>

docs/reference/content/upgrading.md

@@ -12,6 +12,9 @@ title = "Upgrade Considerations"
 The 4.2 release is a minor release as per the definition of [semantic versioning](https://semver.org). As such, there are no breaking
 changes in this release for users upgrading from the 4.1 release.
 
+Note that in this release the Reactive Streams driver has taken an implementation dependency on 
+[Project Reactor](https://projectreactor. io/).  The minimum supported Project Reactor version is *Californium-SR23*.
+
 # Upgrading to the 4.1 Driver
 
 The 4.1 release is a minor release as per the definition of [semantic versioning](https://semver.org). As such, there are no breaking

docs/reference/content/whats-new.md

@@ -9,10 +9,19 @@ title = "What's New"
 
 # What's new in 4.2
 
-This release fully supports all MongoDB releases from versions 2.6 to 4.4. Key new features of the 4.2 Java driver release include:
-
-* Client-side field level encryption has been expanded to support Azure and GCP Keystores.
-* Added support to cache Kerberos tickets so that they can be re-used for multiple authentication requests.
+This release fully supports all MongoDB releases from versions 2.6 to 4.4. New features of the 4.2 Java driver release include:
+
+* The Reactive Streams driver now utilizes [Project Reactor](https://projectreactor.io/) internally. Project reactor follows 
+  the Reactive Streams specification and has greatly simplified the implementation of the driver.
+* Added support for Azure and GCP key stores to client-side field level encryption.
+* Added support for caching Kerberos tickets so that they can be re-used for multiple authentication requests.
+* Added support for constructing legacy `com.mongodb.MongoClient` instances with `MongoClientSettings` or `ConnectionString` as 
+  the configuration, instead of `MongoClientOptions` or `MongoClientURI`.
+* Added support for `explain` of `find` and `aggregate` commands.
+* Added a `JsonObject` class to make encoding from and decoding to JSON more efficient by avoiding an intermediate `Map` representation.
+* Added a `BsonRepresentation` annotation that allows `ObjectId` BSON values to be represented as `String`s in POJO classes. 
+* Added support for the `BsonIgnore` annotation in Scala case classes.
+* Added a `Filters.empty()` method.
 
 # What's new in 4.1