DOCSP-38316: bson (#4)

* DOCSP-38316: bson

* add meta tags

* CC suggestions

Author: rustagir

source/bson.txt

@@ -0,0 +1,44 @@
+.. _scala-bson:
+
+===================
+BSON Implementation
+===================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: documents, storage, codec
+
+The BSON library comprehensively supports `BSON
+<https://bsonspec.org/>`__, the data storage and network transfer format
+that MongoDB uses for documents. BSON, short 
+for Binary `JSON <https://www.json.org/json-en.html>`__, is a
+binary-encoded serialization of JSON-like documents.
+
+For everyday usage there are type aliases and companion objects
+available from the ``org.mongodb.scala.bson`` package. To learn more,
+see the `API documentation
+<{+api+}/org/mongodb/scala/bson/index.html>`__ for the Scala BSON
+implementation.
+
+The following sections describe aspects of the driver's BSON
+implementation:
+
+.. TODO add links
+
+- Documents: describes the driver’s support for BSON document
+  representations
+- Macros: describes the case classes you can use to represent documents in a collection
+- Extended JSON: describes the driver’s support for MongoDB Extended
+  JSON
+
+For advanced usage you might need to use ``org.bson`` directly. See the
+Java Sync driver documentation to learn about the following topics:
+
+- :driver:`Readers and Writers </java/sync/current/fundamentals/data-formats/codecs/#codec>`: describes
+  the driver’s support for stream-based reading and writing of BSON documents
+- :driver:`Codec and CodecRegistry </java/sync/current/fundamentals/data-formats/codecs/>`: describes
+  the driver’s Codec API, an abstraction for producing and consuming BSON document representations
+  using the stream-based readers and writers

source/index.txt

@@ -14,6 +14,7 @@
 
    /installation/
    /get-started/
+   /bson/
    View the Source <https://github.com/mongodb/mongo-java-driver>
    API Documentation <{+api+}/index.html>
    Previous Versions <https://mongodb.github.io/mongo-java-driver/>
@@ -34,6 +35,8 @@ runnable project by following one of the tutorials.
 
 .. - :ref:`scala-reference`
 
+- :ref:`scala-bson`
+
 - `Driver Source GitHub Repository <https://github.com/mongodb/mongo-java-driver>`__
 
 - `API Documentation <{+api+}/index.html>`__