DOCSP-34699 - Serialization reorganization (#144)

Author: mongoKart

config/redirects

@@ -7,3 +7,7 @@ raw: ${prefix}/stable -> ${base}/current/
 
 [*-master]: ${prefix}/${version}/fundamentals/connection/network-compression/ -> ${base}/${version}/
 [*-master]: ${prefix}/${version}/fundamentals/crud/write-operations/change/ -> ${base}/${version}/fundamentals/crud/write-operations/modify/
+[*-master]: ${prefix}/${version}/fundamentals/data-formats/guid-serialization/ -> ${base}/${version}/fundamentals/serialization/guid-serialization/
+[*-master]: ${prefix}/${version}/fundamentals/data-formats/poco/ -> ${base}/${version}/fundamentals/serialization/poco/
+[*-master]: ${prefix}/${version}/fundamentals/data-formats/polymorphism/ -> ${base}/${version}/fundamentals/serialization/polymorphic-objects/
+[*-master]: ${prefix}/${version}/fundamentals/class-mapping/ -> ${base}/${version}/fundamentals/serialization/class-mapping/

snooty.toml

@@ -5,6 +5,7 @@ toc_landing_pages = [
     "/fundamentals/crud",
     "/usage-examples",
     "/fundamentals",
+    "/fundamentals/serialization",
 ]
 
 intersphinx = [

source/fundamentals.txt

@@ -15,24 +15,24 @@ Fundamentals
    /fundamentals/crud
    /fundamentals/builders
    /fundamentals/atlas-search
-   /fundamentals/data-formats
    /fundamentals/stable-api
    /fundamentals/authentication
    /fundamentals/enterprise-authentication
    /fundamentals/linq
-   /fundamentals/class-mapping
+   /fundamentals/bson
+   /fundamentals/serialization
    /fundamentals/logging
    /fundamentals/encrypt-fields
 
 - :ref:`Connecting to MongoDB <csharp-connection>`
 - :ref:`csharp-crud`
 - :ref:`csharp-builders`
 - :ref:`csharp-atlas-search`
-- :ref:`csharp-data-formats`
 - :ref:`csharp-stable-api`
 - :ref:`csharp-authentication-mechanisms`
 - :ref:`csharp-enterprise-authentication-mechanisms`
 - :ref:`csharp-linq`
-- :ref:`csharp-class-mapping`
+- :ref:`csharp-bson`
+- :ref:`csharp-serialization`
 - :ref:`csharp-logging`
 - :ref:`Encrypt Fields <csharp-fle>`

source/fundamentals/data-formats/bson.txt renamed to source/fundamentals/bson.txt

@@ -1,8 +1,8 @@
 .. _csharp-bson:
 
-==============
-Work with BSON
-==============
+===============
+BSON Operations
+===============
 
 .. default-domain:: mongodb
 
@@ -53,7 +53,7 @@ The following code sample shows how to create a ``BsonDocument`` object to repre
 example BSON document. Each key-value pair in the ``BsonDocument`` object is a 
 ``BsonElement`` object. 
 
-.. literalinclude:: ../../includes/fundamentals/code-examples/Bson.cs
+.. literalinclude:: ../includes/fundamentals/code-examples/Bson.cs
    :start-after: start-create
    :end-before: newRestaurant.Add(new BsonElement("restaurant_id", "12345"));
    :language: csharp
@@ -71,7 +71,7 @@ BSON document. The following code sample makes three changes to the previous
 #. Removes the ``"cuisine"`` field
 #. Sets the value of the ``"name"`` field to ``"Mongo's Pizza Palace"``
 
-.. literalinclude:: ../../includes/fundamentals/code-examples/Bson.cs
+.. literalinclude:: ../includes/fundamentals/code-examples/Bson.cs
    :start-after: start-create
    :end-before: end-change
    :language: csharp

source/fundamentals/data-formats.txt

@@ -4,11 +4,26 @@
 Serialization
 =============
 
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta::
+   :keywords: class, map, poco, polymorphism, guid, deserialize
+
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 2
    :class: singlecol
+   
+.. toctree::
+   :caption: Serialization
+
+   /fundamentals/serialization/class-mapping
+   /fundamentals/serialization/poco
+   /fundamentals/serialization/polymorphic-objects
+   /fundamentals/serialization/guid-serialization
 
 Overview
 --------
@@ -121,11 +136,19 @@ IBsonArraySerializer
 Implementing the `IBsonArraySerializer
 <{+api-root+}/T_MongoDB_Bson_Serialization_IBsonArraySerializer.htm>`__
 interface enables the driver to access serialization information for individual
-items in an array. 
+items in an array.
 
 Additional Information
 ----------------------
 
+To learn more about using the {+driver-short+} to serialize {+language+} objects, 
+see the following pages:
+
+- :ref:`csharp-class-mapping`
+- :ref:`csharp-poco`
+- :ref:`csharp-polymorphism`
+- :ref:`csharp-guids`
+
 To learn more about any of the methods or types discussed in this
 guide, see the following API documentation:
 

source/fundamentals/data-formats/serialization.txt renamed to source/fundamentals/serialization.txt

@@ -4,10 +4,17 @@
 Class Mapping
 =============
 
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta::
+   :keywords: .NET, object, attribute, code example, register, configure
+
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 2
+   :depth: 2 
    :class: singlecol
 
 Overview

source/fundamentals/class-mapping.txt renamed to source/fundamentals/serialization/class-mapping.txt

@@ -1,8 +1,15 @@
 .. _csharp-guids:
 
-==================
-GUID Serialization
-==================
+=====
+GUIDs
+=====
+
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta::
+   :keywords: .NET, attribute, property, code example, class, map, bson
 
 .. contents:: On this page
    :local:

source/fundamentals/data-formats/guid-serialization.txt renamed to source/fundamentals/serialization/guid-serialization.txt

@@ -1,8 +1,8 @@
 .. _csharp-poco:
 
-===============
-Work with POCOs
-===============
+=====
+POCOs
+=====
 
 .. contents:: On this page
    :local:

source/fundamentals/data-formats/poco.txt renamed to source/fundamentals/serialization/poco.txt

@@ -15,7 +15,7 @@ Polymorphic Objects
    :values: reference
 
 .. meta::
-   :keywords: inheritance, child, parent, hierarchy, derived, base, serialize, deserialize, root
+   :keywords: .NET, object, attribute, inheritance, child, parent, hierarchy, derived, base, serialize, deserialize, root
 
 Overview
 --------