updating docs from master

Author: craiggwilson

Docs/landing/data/releases.toml

@@ -1,6 +1,6 @@
-current = "2.0.1"
+current = "2.0.0"
 [[versions]]
-  version = "2.0.1"
+  version = "2.0.0"
   status = "rc"
   docs = "http://mongodb.github.io/mongo-csharp-driver/2.0/"
   api = "http://api.mongodb.org/csharp/2.0"
@@ -16,25 +16,25 @@ current = "2.0.1"
   package = "MongoDB.Driver"
   description = "The driver."
   dependencies = ".NET Core Driver,.NET BSON Library"
-  versions = "2.0.1"
+  versions = "2.0.0"
 
 [[drivers]]
   name = ".NET Core Driver"
   package = "MongoDB.Driver.Core"
   description = "The core driver."
   dependencies = ".NET BSON Library"
-  versions = "2.0.1"
+  versions = "2.0.0"
 
 [[drivers]]
   name = ".NET BSON Library"
   package = "MongoDB.Bson"
   description = "The BSON library."
   dependencies = ""
-  versions = "2.0.1"
+  versions = "2.0.0"
 
 [[drivers]]
   name = ".NET Legacy Driver"
   package = "mongocsharpdriver"
   description = "The legacy driver."
   dependencies = ".NET Driver,.NET Core Driver,.NET BSON Library"
-  versions = "2.0.1,1.10.0"
+  versions = "2.0.0,1.10.0"

Docs/reference/config.toml

@@ -10,13 +10,13 @@ canonifyurls = false
 [[menu.main]]
     name = "API Documentation"
     pre = "<i class='fa fa-file-text-o'></i>"
-    weight = 90
+    weight = 800
     identifier = "apiDocs"
     url = "http://api.mongodb.org/csharp/2.0"
 
 [[menu.main]]
     name = "Source Code"
     pre = "<i class='fa fa-github'></i>"
-    weight = 90
+    weight = 900
     identifier = "githubLink"
     url = "https://github.com/mongodb/mongo-csharp-driver/tree/master"

Docs/reference/content/examples/exporting_json.md

@@ -0,0 +1,65 @@
++++
+date = "2015-03-17T15:36:56Z"
+draft = false
+title = "Exporting JSON"
+[menu.main]
+  parent = "Examples"
+  identifier = "Exporting JSON"
+  weight = 10
+  pre = "<i class='fa'></i>"
++++
+
+## Exporting JSON
+
+The .NET BSON library supports writing JSON documents with the [`JsonWriter`]({{< apiref "T_MongoDB_Bson_IO_JsonWriter" >}}) class. 
+
+The program below will export all documents from a collection to a file with one document per line. 
+
+Given the collection's contents:
+
+```bash
+> db.mydata.find()
+{ "_id" : ObjectId("5513306a2dfd32ffd580e323"), "x" : 1.0 }
+{ "_id" : ObjectId("5513306c2dfd32ffd580e324"), "x" : 2.0 }
+{ "_id" : ObjectId("5513306e2dfd32ffd580e325"), "x" : 3.0 }
+{ "_id" : ObjectId("551330712dfd32ffd580e326"), "x" : 4.0 }
+```
+
+And the program:
+
+```csharp
+using MongoDB.Bson;
+using MongoDB.Bson.IO;
+using MongoDB.Bson.Serialization;
+using MongoDB.Driver;
+
+// ...
+
+string outputFileName; // initialize to the output file
+IMongoCollection<BsonDocument> collection; // initialize to the collection to read from
+
+using (var streamWriter = new StreamWriter(outputFileName))
+{
+    await collection.Find(new BsonDocument())
+        .ForEachAsync(async (document) =>
+        {
+            using (var stringWriter = new StringWriter())
+            using (var jsonWriter = new JsonWriter(stringWriter))
+            {
+                var context = BsonSerializationContext.CreateRoot(jsonWriter);
+                collection.DocumentSerializer.Serialize(context, document);
+                var line = stringWriter.ToString();
+                await streamWriter.WriteLineAsync(line);
+            }
+        });
+}
+```
+
+The output file should look this:
+
+```json
+{ "_id" : ObjectId("5513306a2dfd32ffd580e323"), "x" : 1.0 }
+{ "_id" : ObjectId("5513306c2dfd32ffd580e324"), "x" : 2.0 }
+{ "_id" : ObjectId("5513306e2dfd32ffd580e325"), "x" : 3.0 }
+{ "_id" : ObjectId("551330712dfd32ffd580e326"), "x" : 4.0 }
+```

Docs/reference/content/examples/import_export.md

@@ -0,0 +1,63 @@
++++
+date = "2015-03-17T15:36:56Z"
+draft = false
+title = "Importing JSON"
+[menu.main]
+  parent = "Examples"
+  identifier = "Importing JSON"
+  weight = 20
+  pre = "<i class='fa'></i>"
++++
+
+## Importing JSON
+
+The .NET BSON library supports reading JSON documents with the [`JsonReader`]({{< apiref "T_MongoDB_Bson_IO_JsonReader" >}}) class. 
+
+The program below will import all documents from a file with one document per line into the collection.
+
+Given the input file's contents:
+
+```json
+{ "_id" : ObjectId("5513306a2dfd32ffd580e323"), "x" : 1.0 }
+{ "_id" : ObjectId("5513306c2dfd32ffd580e324"), "x" : 2.0 }
+{ "_id" : ObjectId("5513306e2dfd32ffd580e325"), "x" : 3.0 }
+{ "_id" : ObjectId("551330712dfd32ffd580e326"), "x" : 4.0 }
+```
+
+And the program:
+
+```csharp
+using MongoDB.Bson;
+using MongoDB.Bson.IO;
+using MongoDB.Bson.Serialization;
+using MongoDB.Driver;
+
+// ...
+
+string inputFileName; // initialize to the input file
+IMongoCollection<BsonDocument> collection; // initialize to the collection to write to.
+
+using (var streamReader = new StreamReader(inputFileName))
+{
+    string line;
+    while ((line = await streamReader.ReadLineAsync()) != null)
+    {
+        using (var jsonReader = new JsonReader(line))
+        {
+            var context = BsonDeserializationContext.CreateRoot(jsonReader);
+            var document = collection.DocumentSerializer.Deserialize(context);
+            await collection.InsertOneAsync(document);
+        }
+    }
+}
+```
+
+The collection's contents should look like this:
+
+```bash
+> db.mydata.find()
+{ "_id" : ObjectId("5513306a2dfd32ffd580e323"), "x" : 1.0 }
+{ "_id" : ObjectId("5513306c2dfd32ffd580e324"), "x" : 2.0 }
+{ "_id" : ObjectId("5513306e2dfd32ffd580e325"), "x" : 3.0 }
+{ "_id" : ObjectId("551330712dfd32ffd580e326"), "x" : 4.0 }
+```

Docs/reference/content/examples/importing_json.md

@@ -1,6 +1,6 @@
 +++
 date = "2015-03-17T15:36:56Z"
-draft = true
+draft = false
 title = "Examples"
 [menu.main]
   weight = 90
@@ -12,4 +12,8 @@ title = "Examples"
 
 A number of examples have been compiled to show a more thorough usage of certain features and how they interact.
 
-- [Importing and Exporting]({{< relref "examples\import_export.md" >}}): Sample implementations of [mongoimport]({{< docsref "reference/program/mongoimport/" >}}) and [mongoexport]({{< docsref "reference/program/mongoexport/" >}}).
+- [Importing JSON]({{< relref "examples\importing_json.md" >}}): How to read JSON from a file and insert it into a collection.
+- [Exporting JSON]({{< relref "examples\exporting_json.md" >}}): How to read data from a collection and export it to a JSON file.
+- [Mixing Static and Dynamic Data]({{< relref "examples\mixing_static_and_dynamic.md" >}}): How to have both static and dynamic data inside your classes.
+- [Using Tailable Cursors]({{< relref "examples\tailable_cursor.md" >}}): How to use a tailable cursor.
+- [Managing Users]({{< relref "examples\user_management.md" >}}): How to manage users.