CXX-3082 Add Comprehensive Examples (bsoncxx) (#1208)

* Silence common warnings in API examples
* Add bsoncxx and mongocxx topic pages for guides and explanations
* Add bsoncxx topic page for using BSON documents
* Add BSON document usage examples
* Add bsoncxx error handling examples
* Add decimal128 examples
* Add oid examples
* Add validation examples
* CXX-3101 Workaround missing features of mnmlstc/core polyfills
* Refactor API examples to use component registration pattern
* Ensure assertions in examples are always evaluated

Author: eramongodb

docs/api/bsoncxx/examples/bson_documents/access_array.md

@@ -0,0 +1,25 @@
+# Access an Array Element
+
+## By Iteration
+
+### Basic Example
+
+@snippet api/bsoncxx/examples/bson_documents/access_array/basic.cpp Example
+
+### Using Iterators
+
+@snippet api/bsoncxx/examples/bson_documents/access_array/iterators.cpp Example
+
+### Using Algorithms
+
+@snippet api/bsoncxx/examples/bson_documents/access_array/algorithms.cpp Example
+
+## By Key
+
+### Using find()
+
+@snippet api/bsoncxx/examples/bson_documents/access_array/find.cpp Example
+
+### Using the Subscript Operator
+
+@snippet api/bsoncxx/examples/bson_documents/access_array/subscript.cpp Example

docs/api/bsoncxx/examples/bson_documents/access_doc.md

@@ -0,0 +1,25 @@
+# Access a Document Element
+
+## By Iteration
+
+### Basic Example
+
+@snippet api/bsoncxx/examples/bson_documents/access_doc/basic.cpp Example
+
+### Using Iterators
+
+@snippet api/bsoncxx/examples/bson_documents/access_doc/iterators.cpp Example
+
+### Using Algorithms
+
+@snippet api/bsoncxx/examples/bson_documents/access_doc/algorithms.cpp Example
+
+## By Key
+
+### Using find()
+
+@snippet api/bsoncxx/examples/bson_documents/access_doc/find.cpp Example
+
+### Using the Subscript Operator
+
+@snippet api/bsoncxx/examples/bson_documents/access_doc/subscript.cpp Example

docs/api/bsoncxx/examples/bson_documents/create_array.md

@@ -0,0 +1,79 @@
+# Create an Array
+
+## From a JSON String
+
+### Basic Example
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/json_basic.cpp Example
+
+### With Extended JSON
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/json_extended.cpp Example
+
+### With a Sub-Document
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/json_sub_document.cpp Example
+
+### With a Sub-Array
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/json_sub_array.cpp Example
+
+### With a User-Defined Literal
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/json_udl.cpp Example
+
+## Using the Basic Builder
+
+### Basic Example
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_basic.cpp Example
+
+### With make_document
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_make_document.cpp Example
+
+### With Multiple Appends
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_append.cpp Example
+
+### To Create Multiple Documents
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_reset.cpp Example
+
+### With a Value Type
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_value_type.cpp Example
+
+### With a BSON Type
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_bson_type.cpp Example
+
+### With a BSON Value
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_bson_value.cpp Example
+
+### With a Sub-Document
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_sub_document.cpp Example
+
+### With Multiple Sub-Document Appends
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_sub_document_append.cpp Example
+
+### With a Sub-Array
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_sub_array.cpp Example
+
+### With Multiple Sub-Array Appends
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_sub_array_append.cpp Example
+
+## From Raw Bytes
+
+### As a View
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_raw_view.cpp Example
+
+### As a Value
+
+@snippet api/bsoncxx/examples/bson_documents/create_array/builder_raw_value.cpp Example

docs/api/bsoncxx/examples/bson_documents/create_doc.md

@@ -0,0 +1,79 @@
+# Create a Document
+
+## From a JSON String
+
+### Basic Example
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/json_basic.cpp Example
+
+### With Extended JSON
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/json_extended.cpp Example
+
+### With a Sub-Document
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/json_sub_document.cpp Example
+
+### With a Sub-Array
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/json_sub_array.cpp Example
+
+### With a User-Defined Literal
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/json_udl.cpp Example
+
+## Using the Basic Builder
+
+### Basic Example
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_basic.cpp Example
+
+### With make_document
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_make_document.cpp Example
+
+### With Multiple Appends
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_append.cpp Example
+
+### To Create Multiple Documents
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_reset.cpp Example
+
+### With a Value Type
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_value_type.cpp Example
+
+### With a BSON Type
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_bson_type.cpp Example
+
+### With a BSON Value
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_bson_value.cpp Example
+
+### With a Sub-Document
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_sub_document.cpp Example
+
+### With Multiple Sub-Document Appends
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_sub_document_append.cpp Example
+
+### With a Sub-Array
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_sub_array.cpp Example
+
+### With Multiple Sub-Array Appends
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_sub_array_append.cpp Example
+
+## From Raw Bytes
+
+### As a View
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_raw_view.cpp Example
+
+### As a Value
+
+@snippet api/bsoncxx/examples/bson_documents/create_doc/builder_raw_value.cpp Example

docs/api/bsoncxx/examples/bson_documents/elements.md

@@ -0,0 +1,31 @@
+# Query an Element
+
+## In a Document
+
+### For a Single Type
+
+@snippet api/bsoncxx/examples/bson_documents/elements/doc_single.cpp Example
+
+### For Multiple Types
+
+@snippet api/bsoncxx/examples/bson_documents/elements/doc_multi.cpp Example
+
+## In an Array
+
+### For Single Type
+
+@snippet api/bsoncxx/examples/bson_documents/elements/arr_single.cpp Example
+
+### For Multiple Types
+
+@snippet api/bsoncxx/examples/bson_documents/elements/arr_multi.cpp Example
+
+## Comparison
+
+### By Type
+
+@snippet api/bsoncxx/examples/bson_documents/elements/cmp_type.cpp Example
+
+### By BSON Value
+
+@snippet api/bsoncxx/examples/bson_documents/elements/cmp_bson_value.cpp Example

docs/api/bsoncxx/examples/bson_documents/json.md

@@ -0,0 +1,9 @@
+# Convert to a JSON String
+
+## From a Document
+
+@snippet api/bsoncxx/examples/bson_documents/json/document.cpp Example
+
+## From an Array
+
+@snippet api/bsoncxx/examples/bson_documents/json/array.cpp Example

docs/api/bsoncxx/examples/bson_documents/values.md

@@ -0,0 +1,39 @@
+# Obtain a BSON Value
+
+## From a BSON Type
+
+### As a View
+
+@snippet api/bsoncxx/examples/bson_documents/values/bson_type_view.cpp Example
+
+### As a Value
+ 
+@snippet api/bsoncxx/examples/bson_documents/values/bson_type_value.cpp Example
+
+## From a Document Element
+
+### As a View
+
+@snippet api/bsoncxx/examples/bson_documents/values/doc_view.cpp Example
+
+### As a Value
+
+@snippet api/bsoncxx/examples/bson_documents/values/doc_value.cpp Example
+
+## From an Array Element
+
+### As a View
+
+@snippet api/bsoncxx/examples/bson_documents/values/arr_view.cpp Example
+
+### As a Value
+
+@snippet api/bsoncxx/examples/bson_documents/values/arr_value.cpp Example
+
+## From a Value Type
+
+@snippet api/bsoncxx/examples/bson_documents/values/value_type.cpp Example
+
+## With make_value
+
+@snippet api/bsoncxx/examples/bson_documents/values/make_value.cpp Example