GODRIVER-852 Add documentation warning against the use of duplicate key names

bson/bson.go

@@ -25,6 +25,8 @@ type Zeroer interface {
 // D is an ordered representation of a BSON document. This type should be used when the order of the elements matters,
 // such as MongoDB command documents. If the order of the elements does not matter, an M should be used instead.
 //
+// A D should not be constructed with duplicate key names, as that can cause undefined server behavior.
+//
 // Example usage:
 //
 // 		bson.D{{"foo", "bar"}, {"hello", "world"}, {"pi", 3.14159}}

bson/doc.go

@@ -29,6 +29,8 @@
 // slice and M is a map. For more information about the use cases for these types, see the documentation on the type
 // definitions.
 //
+// Note that a D should not be constructed with duplicate key names, as that can cause undefined server behavior.
+//
 // Example:
 // 		bson.D{{"foo", "bar"}, {"hello", "world"}, {"pi", 3.14159}}
 //		bson.M{"foo": "bar", "hello": "world", "pi": 3.14159}

mongo/collection.go

@@ -321,6 +321,7 @@ func (coll *Collection) insert(ctx context.Context, documents []interface{},
 // field when transformed into BSON, one will be added automatically to the marshalled document. The original document
 // will not be modified. The _id can be retrieved from the InsertedID field of the returned InsertOneResult.
 //
+//
 // The opts parameter can be used to specify options for the operation (see the options.InsertOneOptions documentation.)
 //
 // For more information about the command, see https://docs.mongodb.com/manual/reference/command/insert/.