Docs reorg and added Async connection page

JAVA-1728 JAVA-1732

Author: rozza

docs/reference/config.toml

@@ -4,6 +4,9 @@ title = "MongoDB Java Driver"
 theme = "mongodb"
 canonifyurls = false
 
+[blackfriday]
+  plainIdAnchors = true
+
 # Example custom menu Item (Useful for linking to API docs)
 # [[menu.main]]
 #     name = "Issues & Help"

docs/reference/content/reference/bson/codecs.md renamed to docs/reference/content/bson/codecs.md

@@ -3,7 +3,7 @@ date = "2015-03-19T14:27:51-04:00"
 title = "Codec and CodecRegistry"
 [menu.main]
   parent = "BSON"
-  weight = 10
+  weight = 40
   pre = "<i class='fa'></i>"
 +++
 

docs/reference/content/reference/bson/documents.md renamed to docs/reference/content/bson/documents.md

@@ -3,7 +3,7 @@ date = "2015-03-19T14:27:51-04:00"
 title = "Documents"
 [menu.main]
   parent = "BSON"
-  weight = 1
+  weight = 20
   pre = "<i class='fa'></i>"
 +++
 
@@ -93,4 +93,4 @@ collection.find(new BasicDBObject("x", 1));
 
 
 
-    
+    

docs/reference/content/reference/bson/extended-json.md renamed to docs/reference/content/bson/extended-json.md

@@ -3,7 +3,7 @@ date = "2015-03-19T14:27:51-04:00"
 title = "Extended JSON"
 [menu.main]
   parent = "BSON"
-  weight = 20
+  weight = 50
   pre = "<i class='fa'></i>"
 +++
 

docs/reference/content/reference/bson/index.md renamed to docs/reference/content/bson/index.md

@@ -2,14 +2,14 @@
 date = "2015-03-19T12:53:30-04:00"
 title = "BSON"
 [menu.main]
-  parent = "Reference"
-  weight = 10
-  pre = "<i class='fa'></i>"
+  identifier = "BSON"
+  weight = 40
+  pre = "<i class='fa fa-th'></i>"
 +++
 
 ## BSON
 
-The driver comprehensively supports [BSON](http://www.bsonspec.org), the data storage and network transfer format that MongoDB uses for 
+The BSON library comprehensively supports [BSON](http://www.bsonspec.org), the data storage and network transfer format that MongoDB uses for 
 “documents". BSON, short for Binary [JSON](http://json.org/), is a binary-encoded serialization of JSON-like documents.
 
 - [Documents]({{< relref "documents.md" >}}): Documentation of the driver's support for BSON document representations

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

@@ -0,0 +1,25 @@
++++
+date = "2015-03-17T15:36:56Z"
+title = "Installation Guide"
+[menu.main]
+  parent = "BSON"
+  weight = 50
+  pre = "<i class='fa'></i>"
++++
+
+# Installation
+
+The BSON library is a required dependency of all the MongoDB Java drivers and if using a  dependency management system, it will be 
+automatically installed alongside the driver, however, it can be used as a standalone library. 
+The recommended way to get started using one of the drivers in your project is with a dependency management system.
+
+{{< distroPicker >}}
+
+
+## BSON
+
+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.0.0-rc1" >}}

docs/reference/content/reference/bson/readers-and-writers.md renamed to docs/reference/content/bson/readers-and-writers.md

@@ -3,7 +3,7 @@ date = "2015-03-19T14:27:51-04:00"
 title = "Readers and Writers"
 [menu.main]
   parent = "BSON"
-  weight = 5
+  weight = 30
   pre = "<i class='fa'></i>"
 +++
 

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

@@ -0,0 +1,17 @@
++++
+date = "2015-03-17T15:36:56Z"
+title = "Getting Started"
+[menu.main]
+  parent = "MongoDB Async Driver"
+  identifier = "Async Getting Started"
+  weight = 30
+  pre = "<i class='fa fa-road'></i>"
++++
+
+## Getting Started
+
+To help you get started quickly on the new driver, follow:
+
+  * [Installation]({{< ref "driver-async/getting-started/installation-guide.md" >}})
+  * [Quick Tour]({{< ref "driver-async/getting-started/quick-tour.md" >}})
+  * [Admin Quick Tour]({{< ref "driver-async/getting-started/quick-tour-admin.md" >}})

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

@@ -0,0 +1,20 @@
++++
+date = "2015-03-17T15:36:56Z"
+title = "Installation Guide"
+[menu.main]
+  parent = "Async Getting Started"
+  identifier = "Async Installation Guide"
+  weight = 1
+  pre = "<i class='fa'></i>"
++++
+
+# Installation
+
+The recommended way to get started using one of the drivers in your project is with a dependency management system.
+
+{{< distroPicker >}}
+
+## MongoDB Async Driver
+The new asynchronous API that can leverage either Netty or Java 7's AsynchronousSocketChannel for fast and non-blocking IO.
+
+{{< install artifactId="mongodb-driver-async" version="3.0.0" >}}

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

@@ -1,16 +1,17 @@
 +++
 date = "2015-03-17T15:36:56Z"
-title = "Async Admin Quick Tour"
+title = "Admin Quick Tour"
 [menu.main]
-  parent = "Getting Started"
+  parent = "Async Getting Started"
+  identifier = "Async Admin Quick Tour"
   weight = 50
   pre = "<i class='fa'></i>"
 +++
 
 # MongoDB Driver Admin Quick Tour
 
 This is the second part of the MongoDB driver quick tour. In the
-[quick tour]({{< relref "getting-started/async-quick-tour.md" >}}) we looked at how to
+[quick tour]({{< relref "driver-async/getting-started/quick-tour.md" >}}) we looked at how to
 use the Async Java driver to execute basic CRUD operations.  In this section we'll look at some of the
 administrative features available in the driver.
 
@@ -19,7 +20,7 @@ that can be found with the [driver
 source]({{< srcref "driver-async/src/examples/tour/QuickTourAdmin.java">}}).
 
 {{% note %}}
-See the [installation guide]({{< relref "getting-started/installation-guide.md" >}})
+See the [installation guide]({{< relref "driver-async/getting-started/installation-guide.md" >}})
 for instructions on how to install the MongoDB Driver.
 {{% /note %}}