content updates.

Author: craiggwilson

Docs/reference/content/examples/index.md

@@ -4,7 +4,7 @@ draft = true
 title = "Examples"
 [menu.main]
   weight = 90
-  pre = "<i class='fa'></i>"
+  pre = "<i class='fa fa-code'></i>"
 +++
 
 ## Examples

Docs/reference/content/getting_started/reading_and_writing.md

@@ -65,13 +65,16 @@ var result = await collection.UpdateOneAsync(
 
 This will generate a filter of `{ Name: "Tom" }` and an update specification of `{ $set: { Profession: "Musician" } }`. Only one document will get updated even if there is more than one person named "Tom" because we used [`UpdateOneAsync`]({{< apiref "M_MongoDB_Driver_IMongoCollection_1_UpdateOneAsync" >}}) instead of [`UpdateManyAsync`]({{< apiref "M_MongoDB_Driver_IMongoCollection_1_UpdateManyAsync" >}}). More information on updates is available in the [reference guide]({{< relref "reference\driver\crud\writing.md#update-and-replace" >}}).
 
-Alternatively, if we want to replace a  document completely, we can use the [`ReplaceOneAsync`]({{< apiref "M_MongoDB_Driver_IMongoCollection_1_ReplaceOneAsync" >}}) method. Assuming Tom's `Id` value is "550c4aa98e59471bddf68eef":
+Alternatively, if we want to replace a  document completely, we can use the [`ReplaceOneAsync`]({{< apiref "M_MongoDB_Driver_IMongoCollection_1_ReplaceOneAsync" >}}) method. Assuming Tom's `Id` value is `550c4aa98e59471bddf68eef`:
 
 ```csharp
-var tom = await collection.Find(x => x.Id == ObjectId.Parse("550c4aa98e59471bddf68eef")).SingleAsync();
+var tom = await collection.Find(x => x.Id == ObjectId.Parse("550c4aa98e59471bddf68eef"))
+	.SingleAsync();
+
 tom.Name = "Thomas";
 tom.Age = 43;
 tom.Profession = "Hacker";
+
 var result = await collection.ReplaceOneAsync(x => x.Id == tom.Id, tom);
 ```
 

Docs/reference/content/reference/bson/bson.md

@@ -92,12 +92,12 @@ using (var writer = new JsonWriter(output))
 
 [`JsonWriter`]({{< apiref "T_MongoDB_Bson_IO_JsonWriter" >}}) supports writing strict JSON as well as both flavors of [MongoDB Extended JSON]({{< docsref "reference/mongodb-extended-json/" >}}). This, and other things, can be customized with the [`JsonWriterSettings`]({{< apiref "T_MongoDB_Bson_IO_JsonWriterSettings" >}}) class.
 
-For instance, to write in a format for the [MongoDB Shell](http://docs.mongodb.org/manual/administration/scripting/), you can set the [`OutputMode`]({{< apiref "M_MongoDB_Bson_IO_JsonWriterSettings_OutputMode" >}}) to `Shell` and also set the [`Version`]({{< apiref "M_MongoDB_Bson_IO_JsonWriterSettings_Version" >}}) to the desired shell version.
+For instance, to write in a format for the [MongoDB Shell](http://docs.mongodb.org/manual/administration/scripting/), you can set the [`OutputMode`]({{< apiref "P_MongoDB_Bson_IO_JsonWriterSettings_OutputMode" >}}) to `Shell` and also set the [`ShellVersion`]({{< apiref "P_MongoDB_Bson_IO_JsonWriterSettings_ShellVersion" >}}) to the desired shell version.
 
 ```csharp
 var settings = new JsonWriterSettings
 {
 	OutputMode = JsonOutputMode.Shell,
-	Version = new Version(3.0) // target the syntax of MongoDB 3.0
+	ShellVersion = new Version(3.0) // target the syntax of MongoDB 3.0
 };
 ```

Docs/reference/content/reference/bson/mapping/index.md

@@ -19,15 +19,15 @@ The .NET BSON library supports mapping these classes to and from BSON/JSON using
 
 In a majority of cases, the driver will be able to automatically map your class for you. This will happen if you begin to use a class for which no [serializer]({{< relref "reference\bson\serialization.md#serializers" >}}) has yet been registered in the [serializer registry]({{< relref "reference\bson\serialization.md#serializer-registry" >}}).
 
-You can choose to register the class map using the [`RegisterClassMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_RegisterClassMap_1" >}}) method:
+You can choose to register the class map using the [`RegisterClassMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_RegisterClassMap__1_1" >}}) method:
 
 ```csharp
 BsonClassMap.RegisterClassMap<MyClass>();
 ```
 
 {{% note %}}It is very important that the registration of class maps occur prior to them being needed. The best place to register them is at app startup prior to initializing a connection with MongoDB.{{% /note %}}
 
-If you want to control the creation of the class map, you can provide your own initializatzion code in the form of a lambda expression:
+If you want to control the creation of the class map, you can provide your own initialization code in the form of a lambda expression:
 
 ```csharp
 BsonClassMap.RegisterClassMap<MyClass>(cm => 
@@ -37,11 +37,11 @@ BsonClassMap.RegisterClassMap<MyClass>(cm =>
 });
 ```
 
-When your lambda expression is executed, the `cm` (short for class map) parameter is passed an empty class map for you to fill in. In this example, two properties are added to the class map by calling the [`MapMember`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_MapMember_1" >}}) method. The arguments to the method are themselves lambda expressions which identify the member of the class. The advantage of using a lambda expression instead of just a string parameter with the name of the property is that Intellisense and compile time checking ensure that you can’t misspell the name of the property.
+When your lambda expression is executed, the `cm` (short for class map) parameter is passed an empty class map for you to fill in. In this example, two properties are added to the class map by calling the [`MapMember`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_MapMember__1" >}}) method. The arguments to the method are themselves lambda expressions which identify the member of the class. The advantage of using a lambda expression instead of just a string parameter with the name of the property is that Intellisense and compile time checking ensure that you can’t misspell the name of the property.
 
 ## AutoMap
 
-It is also possible to use automapping and then override some of the results using the [`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_AutoMap" >}}) method. This method should be called first in the lambda expression.
+It is also possible to use automapping and then override some of the results using the [`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_AutoMap" >}}) method. This method should be called first in the lambda expression.
 
 ```csharp
 BsonClassMap.RegisterClassMap<MyClass>(cm => 
@@ -52,7 +52,7 @@ BsonClassMap.RegisterClassMap<MyClass>(cm =>
 });
 ```
 
-[`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_AutoMap" >}}) uses conventions to map the class and its members. See the [convention documentation]({{< relref "reference\bson\mapping\conventions.md" >}}) for more information.
+[`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_AutoMap" >}}) uses conventions to map the class and its members. See the [convention documentation]({{< relref "reference\bson\mapping\conventions.md" >}}) for more information.
 
 
 ## Class Customization
@@ -87,7 +87,7 @@ BsonClassMap.RegisterClassMap<MyClass>(cm =>
 
 ### Supporting Extra Elements
 
-You can design your class to be capable of handling any extra elements that might be found in a BSON document during deserialization. To do so, you must have a property of type [`BsonDocument`]({{< apiref "T_MongoDB_Bson_BsonDocument" >}}) (or [`IDictionary<string, object>`]({{< msdnref "" >}})) and you must identify that property as the one that should hold any extra elements that are found. By [convention]({{< relref "reference\bson\mapping\conventions.md" >}}), the member may be named "ExtraElements". For example:
+You can design your class to be capable of handling any extra elements that might be found in a BSON document during deserialization. To do so, you must have a property of type [`BsonDocument`]({{< apiref "T_MongoDB_Bson_BsonDocument" >}}) (or [`IDictionary<string, object>`]({{< msdnref "s4ys34ea" >}})) and you must identify that property as the one that should hold any extra elements that are found. By [convention]({{< relref "reference\bson\mapping\conventions.md" >}}), the member may be named `ExtraElements`. For example:
 
 ```csharp
 public MyClass 
@@ -322,19 +322,19 @@ BsonClassMap.RegisterClassMap<MyClass>(cm =>
 
 When you Insert a document, the driver checks to see if the `Id` member has been assigned a value and, if not, generates a new unique value for it. Since the `Id` member can be of any type, the driver requires the help of an [`IIdGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IIdGenerator" >}}) to check whether the `Id` has a value assigned to it and to generate a new value if necessary. The driver has the following Id generators built-in:
 
-- [`ObjectIdGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_ObjectIdGenerator" >}})
-- [`StringObjectIdGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_StringObjectIdGenerator" >}})
-- [`GuidGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_GuidGenerator" >}})
-- [`CombGuidGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_CombGuidGenerator" >}})
-- [`NullIdChecker`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_NullIdChecker" >}})
-- [`ZeroIdChecker<T>`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_ZeroIdChecker_1" >}})
-- [`BsonObjectIdGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_BsonObjectIdGenerator" >}})
+- [`ObjectIdGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_ObjectIdGenerator" >}})
+- [`StringObjectIdGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_StringObjectIdGenerator" >}})
+- [`GuidGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_GuidGenerator" >}})
+- [`CombGuidGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_CombGuidGenerator" >}})
+- [`NullIdChecker`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_NullIdChecker" >}})
+- [`ZeroIdChecker<T>`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_ZeroIdChecker_1" >}})
+- [`BsonObjectIdGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_BsonObjectIdGenerator" >}})
 
 Some of these Id generators are used automatically for commonly used `Id` types:
 
-- [`GuidGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_GuidGenerator" >}}) is used for a [`Guid`]({{< msdnref "system.guid" >}})
-- [`ObjectIdGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_ObjectIdGenerator" >}}) is used for an [`ObjectId`]({{< apiref "T_MongoDB_Bson_ObjectId" >}})
-- [`StringObjectIdGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_StringObjectIdGenerator" >}}) is used for a [`string`]({{< msdnref "system.string" >}}) represented externally as [`ObjectId`]({{< apiref "T_MongoDB_Bson_ObjectId" >}})
+- [`GuidGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_GuidGenerator" >}}) is used for a [`Guid`]({{< msdnref "system.guid" >}})
+- [`ObjectIdGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_ObjectIdGenerator" >}}) is used for an [`ObjectId`]({{< apiref "T_MongoDB_Bson_ObjectId" >}})
+- [`StringObjectIdGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_StringObjectIdGenerator" >}}) is used for a [`string`]({{< msdnref "system.string" >}}) represented externally as [`ObjectId`]({{< apiref "T_MongoDB_Bson_ObjectId" >}})
 
 To specify the Id generator via an attribute:
 
@@ -356,7 +356,7 @@ BsonClassMap.RegisterClassMap<MyClass>(cm =>
 });
 ```
 
-You could also say that you want to use the [`CombGuidGenerator`]({{ apiref "T_MongoDB_Bson_Serialization_IdGenerators_CombGuidGenerator" >}}) for all Guids.
+You could also say that you want to use the [`CombGuidGenerator`]({{< apiref "T_MongoDB_Bson_Serialization_IdGenerators_CombGuidGenerator" >}}) for all Guids.
 
 ```csharp
 BsonSerializer.RegisterIdGenerator(
@@ -388,7 +388,7 @@ BsonClassMap.RegisterClassMap<MyClass>(cm =>
 });
 ```
 
-When using code, [`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_AutoMap" >}}) will have initially added the property to the class map automatically. [`UnmapMember`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_UnmapMember_1" >}}) will remove it.
+When using code, [`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_AutoMap" >}}) will have initially added the property to the class map automatically. [`UnmapMember`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_UnmapMember__1" >}}) will remove it.
 
 
 ### Ignoring Default Values
@@ -448,7 +448,7 @@ public class MyClass
 
 ### Ignoring a Member at Runtime
 
-Sometimes the decision whether to serialize a member or not is more complicated than just whether the value is `null` or equal to the default value. In these cases, you can write a method that determines whether a value should be serialized. Usually the method for member Xyz is named ShouldSerializeXyz. If you follow this naming convention then [`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_1_AutoMap" >}}) will automatically detect the method and use it. For example:
+Sometimes the decision whether to serialize a member or not is more complicated than just whether the value is `null` or equal to the default value. In these cases, you can write a method that determines whether a value should be serialized. Usually the method for member Xyz is named ShouldSerializeXyz. If you follow this naming convention then [`AutoMap`]({{< apiref "M_MongoDB_Bson_Serialization_BsonClassMap_AutoMap" >}}) will automatically detect the method and use it. For example:
 
 ```csharp
 public class Employee 
@@ -551,7 +551,7 @@ public class C
 }
 ```
 
-When done via code, a [`DictionaryInterfaceImplementerSerializer`]({{< apiref "T_MongoDB_Bson_Serialization_Serializers_DictionaryInterfaceImplementerSerializer" >}}) should be set:
+When done via code, a [`DictionaryInterfaceImplementerSerializer`]({{< apiref "T_MongoDB_Bson_Serialization_Serializers_DictionaryInterfaceImplementerSerializer_1" >}}) should be set:
 
 ```csharp
 BsonClassMap.RegisterClassMap<C>(cm => 
@@ -621,8 +621,8 @@ BsonClassMap.RegisterClassMap<Employee>(cm =>
 
 It is possible to implement custom attributes to contribute to the serialization infrastructure. There are 3 interfaces you might want to implement:
 
-- [`IBsonClassMapAttribute`]({{< apiref "T_MongoDB_Bson_Serialization_Attributes_IBsonClassMapAttribute" >}}) is used to contribute to a class map.
-- [`IBsonMemberMapAttribute`]({{< apiref "T_MongoDB_Bson_Serialization_Attributes_IBsonMemberMapAttribute" >}}) is used to contribute to a member map.
-- [`IBsonCreatorMapAttribute`]({{< apiref "T_MongoDB_Bson_Serialization_Attributes_IBsonCreatorMapAttribute" >}}) is used to contribute to a creator map.
+- [`IBsonClassMapAttribute`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonClassMapAttribute" >}}) is used to contribute to a class map.
+- [`IBsonMemberMapAttribute`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonMemberMapAttribute" >}}) is used to contribute to a member map.
+- [`IBsonCreatorMapAttribute`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonCreatorMapAttribute" >}}) is used to contribute to a creator map.
 
 All the provided attributes implement one or more of these interfaces, so they are good examples of how these interfaces function.

Docs/reference/content/reference/bson/serialization.md

@@ -16,7 +16,7 @@ Serialization is the process of mapping an object to and from a BSON document. T
 
 ## Serializer Registry
 
-The serializer registry contains all the [`IBsonSerializers`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonSerializer" >}}) that have been registered. It can be accessed via the [`SerializerRegistry`]({{< apiref "P_MongoDB_Bson_BsonSerializer_SerializerRegistry" >}}) property of the static class [`BsonSerializer`]({{< apiref "MongoDB_Bson_BsonSerializer" >}}). 
+The serializer registry contains all the [`IBsonSerializers`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonSerializer" >}}) that have been registered. It can be accessed via the [`SerializerRegistry`]({{< apiref "P_MongoDB_Bson_Serialization_BsonSerializer_SerializerRegistry" >}}) property of the static class [`BsonSerializer`]({{< apiref "T_MongoDB_Bson_Serialization_BsonSerializer" >}}). 
 
 {{% note %}}This is a global registry. Currently, you cannot use multiple registries in a single application.{{% /note %}}
 
@@ -28,7 +28,7 @@ The [serializer registry]({{< relref "#serializer-registry" >}}) is powered by a
 
 ### Implementation
 
-To implement an [`IBsonSerializationProvider`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonSerializationProvider" >}}), create a class that implements the interface and register it using the [`RegisterSerializationProvider`]({{< apiref "T_MongoDB_Bson_BsonSerializer_RegisterSerializationProvider" >}}) method.
+To implement an [`IBsonSerializationProvider`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonSerializationProvider" >}}), create a class that implements the interface and register it using the [`RegisterSerializationProvider`]({{< apiref "M_MongoDB_Bson_Serialization_BsonSerializer_RegisterSerializationProvider" >}}) method.
 
 ```csharp
 class MyProvider : IBsonSerializationProvider
@@ -67,7 +67,7 @@ using (var reader = new JsonReader(jsonString))
 
 {{% note class="warning" %}}Writing custom serializers to handle both normal cases and edge cases can be very tricky.{{% /note %}}
 
-To implement a custom [`IBsonSerializer`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonSerializer" >}}), it is best to inherit from [`SerializerBase<T>`]({{< apiref "T_MongoDB_Bson_Serialization_Serializers_SerializerBase_1" >}}) and override the [`Deserializer`]({{< apiref "M_MongoDB_Bson_Serialization_Serializers_SerializerBase_1_Deserialize" >}}) and [`Serialize`]({{< apiref "M_MongoDB_Bson_Serialization_Serializers_SerializerBase_1_Serialize" >}}) methods.
+To implement a custom [`IBsonSerializer`]({{< apiref "T_MongoDB_Bson_Serialization_IBsonSerializer" >}}), it is best to inherit from [`SerializerBase<T>`]({{< apiref "T_MongoDB_Bson_Serialization_Serializers_SerializerBase_1" >}}) and override the [`Deserialize`]({{< apiref "M_MongoDB_Bson_Serialization_Serializers_SerializerBase_1_Deserialize" >}}) and [`Serialize`]({{< apiref "M_MongoDB_Bson_Serialization_Serializers_SerializerBase_1_Serialize" >}}) methods.
 
 For example, it implement a serializer that reads an [`Int32`]({{< msdnref "system.int32" >}}):
 
@@ -122,7 +122,7 @@ Notice that we are testing the current BsonType while reading and making decisio
 
 {{% note %}}The built-in [`Int32Serializer`]({{< apiref "T_MongoDB_Bson_Serialization_Serializers_Int32Serializer" >}}) accounts for this as well as other such items.{{% /note %}}
 
-You can register your serializer using the [`RegisterSerializer`]({{< apiref "T_MongoDB_Bson_BsonSerializer_RegisterSerializer" >}}) or implement a [serialization provider]({{< relref "#serialization-provider" >}}).
+You can register your serializer using the [`RegisterSerializer`]({{< apiref "M_MongoDB_Bson_Serialization_BsonSerializer_RegisterSerializer" >}}) or implement a [serialization provider]({{< relref "#serialization-provider" >}}).
 
 
 ### Opt-in Interfaces