Reorganization of the reference content

Author: jyemin

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

@@ -1,14 +1,14 @@
 +++
 date = "2015-03-19T14:27:51-04:00"
 draft = true
-title = "JSON support"
+title = "Extended JSON"
 [menu.main]
-  parent = "Reference"
+  parent = "BSON"
   weight = 50
   pre = "<i class='fa'></i>"
 +++
 
-## JSON Support
+## MongoDB Extended JSON
 
 The Java driver supports reading and writing JSON documents with the [JsonReader]({{< apiref "org/bson/json/JsonReader" >}}) and
 [JsonWriter]({{< apiref "org/bson/json/JsonWriter" >}}) classes, which can read/write both flavors of 

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

@@ -0,0 +1,15 @@
++++
+date = "2015-03-19T12:53:30-04:00"
+draft = true
+title = "BSON"
+[menu.main]
+  parent = "Reference"
+  weight = 10
+  pre = "<i class='fa'></i>"
++++
+
+## BSON
+
+The driver comprehensively supports [BSON](http://www.bsonspec.org), the data storage and network transfer format for “documents”.
+
+- [MongoDB Extended JSON]({{< relref "extended-json.md" >}})

docs/reference/content/reference/authenticating.md renamed to docs/reference/content/reference/connecting/authenticating.md

@@ -2,8 +2,8 @@
 date = "2015-03-19T14:27:51-04:00"
 title = "Authenticating"
 [menu.main]
-  parent = "Reference"
-  weight = 35
+  parent = "Connecting"
+  weight = 20
   pre = "<i class='fa'></i>"
 +++
 

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

@@ -3,8 +3,8 @@ date = "2015-03-19T12:53:26-04:00"
 draft = true
 title = "SSL"
 [menu.main]
-  parent = "Reference"
-  weight = 32
+  parent = "Connecting"
+  weight = 10
   pre = "<i class='fa'></i>"
 +++
 

docs/reference/content/reference/ssl.md renamed to docs/reference/content/reference/connecting/ssl.md

@@ -6,6 +6,12 @@ title = "Reference"
   pre = "<i class='fa fa-book'></i>"
 +++
 
-## MongoDB Java Driver Reference Documentation
+## Reference Page index
+
+The reference documentation is not an API reference. You can review those [here](http://api.mongodb.org/java/3.0/). Instead, the 
+reference documentation will focus on high-level documentation and use-cases.  
+
+- [BSON]({{< relref "reference/bson/index.md" >}})
+- [Connecting]({{< relref "reference/connecting/index.md" >}})
+- [Management]({{< relref "reference/management/index.md" >}})
 
-This is the reference documentation.  Not sure what to say yet at the top level.

docs/reference/content/reference/index.md

@@ -0,0 +1,15 @@
++++
+date = "2015-03-19T14:27:51-04:00"
+title = "Management"
+[menu.main]
+  parent = "Reference"
+  weight = 80
+  pre = "<i class='fa'></i>"
++++
+
+## Management
+
+The driver provides two mechanisms for examining its state:
+
+- [Logging]({{< relref "logging.md" >}}): Comprehensive logging of all operations using [SLF4J](http://www.slf4j.org/)
+- [Management]({{< relref "monitoring.md" >}}): Built on [JMX](http://docs.oracle.com/javase/8/docs/technotes/guides/jmx/) 

docs/reference/content/reference/management/index.md

@@ -2,8 +2,8 @@
 date = "2015-03-18T21:14:20-04:00"
 title = "Logging"
 [menu.main]
-  parent = "Reference"
-  weight = 90
+  parent = "Management"
+  weight = 10
   pre = "<i class='fa'></i>"
 +++
 

docs/reference/content/reference/logging.md renamed to docs/reference/content/reference/management/logging.md

@@ -2,14 +2,18 @@
 date = "2015-03-19T12:53:26-04:00"
 title = "Monitoring"
 [menu.main]
-  parent = "Reference"
+  parent = "Management"
   weight = 100
   pre = "<i class='fa'></i>"
 +++
 
 # Monitoring
 
-The driver currently MXBean instances of a single type:
+The driver uses [JMX](http://docs.oracle.com/javase/8/docs/technotes/guides/jmx/) to create
+[MXBeans](http://docs.oracle.com/javase/tutorial/jmx/mbeans/mxbeans.html) that allow an
+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).
  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/reference/monitoring.md renamed to docs/reference/content/reference/management/monitoring.md

@@ -19,7 +19,7 @@ Before upgrading to 3.0.0, compile against 2.13.0 with deprecation warnings enab
 The minimum JVM is now Java 6: however, specific features require Java 7:
 
 - SSL support requires Java 7 in order to perform host name verification, which is enabled by default.  See
-[SSL]({{< relref "connecting.md#SSL" >}}) for details on how to disable host name verification.
+[SSL]({{< relref "reference/connecting/ssl.md" >}}) for details on how to disable host name verification.
 - 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 "async" >}}) for details on configuring the driver to use [Netty](http://netty.io/) instead.