wip

mongoKart · mongoKart · commit 9042203113d8 · 2025-04-04T10:12:41.000-05:00
diff --git a/source/aggregation.txt b/source/aggregation.txt
diff --git a/source/aggregation/linq.txt b/source/aggregation/linq.txt
diff --git a/source/atlas-vector-search.txt b/source/atlas-vector-search.txt
@@ -1,4 +1,21 @@
-.. TODO: integrate into existing page
+.. _csharp-atlas-vector-search:
+
+===================
+Atlas Vector Search
+===================
+
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta::
+   :keywords: semantic 
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
 
 Sample Class
 ------------
diff --git a/source/connect/connection-options/csot.txt b/source/connect/connection-options/csot.txt
diff --git a/source/connect/connection-targets.txt b/source/connect/connection-targets.txt
diff --git a/source/connect/connection-troubleshooting.txt b/source/connect/connection-troubleshooting.txt
@@ -18,8 +18,6 @@ using the {+driver-long+} to connect to a MongoDB deployment.
    This page addresses only connection issues. If you encounter any other issues
    with MongoDB or the driver, visit the following resources:
 
-   - The :ref:`Frequently Asked Questions (FAQ) <csharp-faq>` for the
-     {+driver-short+}
    - The :ref:`Issues & Help <csharp-issues-help>` page, which has
      information about reporting bugs, contributing to the driver, and 
      finding additional resources
diff --git a/source/crud.txt b/source/crud.txt
@@ -13,7 +13,8 @@ CRUD Operations
 
    Insert Documents </crud/insert>
    Query Documents </crud/query>
-   Update Documents </crud/update>
+   Update One Document </crud/update-one>
+   Update Many Documents </crud/update-many>
    Replace Documents </crud/replace>
    Delete Documents </crud/delete>
    Bulk Write Operations </crud/bulk-write>
diff --git a/source/crud/insert.txt b/source/crud/insert.txt
@@ -228,8 +228,8 @@ The following code uses the ``InsertMany()`` method to insert five new
 
 The ``InsertMany()`` method has no return value. You can verify that
 your documents were successfully inserted by executing a ``Find()``
-operation on the collection. For an example on how to find a document,
-see :ref:`csharp-find-one`.
+operation on the collection. For an example of how to find a document,
+see :ref:`csharp-find`.
 
 .. _csharp-ordered-behavior:
 
diff --git a/source/crud/query/count.txt b/source/crud/query/count.txt
@@ -231,7 +231,6 @@ guides:
 - :ref:`csharp-specify-query`
 - :ref:`csharp-bson`
 - :ref:`csharp-guids`
-- :ref:`csharp-builders` 
 - :ref:`csharp-poco`
 
 API Documentation
diff --git a/source/crud/query/find.txt b/source/crud/query/find.txt
@@ -1,4 +1,4 @@
-.. _csharp-retrieve:
+.. _csharp-find:
 
 =============
 Retrieve Data
diff --git a/source/crud/query/specify-documents-to-return.txt b/source/crud/query/specify-documents-to-return.txt
@@ -203,7 +203,7 @@ skipping the first ``10`` documents:
 Additional Information
 ----------------------
 
-For more information about retrieving documents, see the :ref:`csharp-retrieve` guide.
+For more information about retrieving documents, see the :ref:`csharp-find` guide.
 
 For more information about specifying a query, see the :ref:`csharp-specify-query` guide.
 
diff --git a/source/crud/query/specify-query.txt b/source/crud/query/specify-query.txt
@@ -109,8 +109,6 @@ same documents as the preceding example:
 
       var result = _guitarsCollection.Find(Builders<Guitar>.Filter.Empty).ToList();
 
-To learn more about using builders, see :ref:`csharp-builders`.
-
 Comparison Operators
 --------------------
 
@@ -171,9 +169,6 @@ same documents as the preceding example:
 
       { "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }
 
-
-To learn more about using builders, see :ref:`csharp-builders`.
-
 Logical Operators
 -----------------
 
@@ -232,8 +227,6 @@ same documents as the preceding example:
 
       { "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }
 
-To learn more about using builders, see :ref:`csharp-builders`.
-
 Array Operators
 ---------------
 
@@ -285,8 +278,6 @@ documents that have 3 elements in the ``models`` field:
       { "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }
       { "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }
 
-To learn more about using builders, see :ref:`csharp-builders`.
-
 Element Operators
 -----------------
 
@@ -313,8 +304,6 @@ documents that have a ``rating`` field:
       { "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }
       { "_id" : 5, "make" : "Ibanez", "models" : ["RG", "AZ"], "establishedYear" : 1957, "rating" : 7 }
 
-To learn more about using builders, see :ref:`csharp-builders`.
-
 Evaluation Operators
 --------------------
 
@@ -332,7 +321,7 @@ documents that have a value in the ``make`` field that starts with the letter
 .. io-code-block::
    :copyable:
 
-   .. input:: ../../../includes/fundamentals/code-examples/specify-query/FindRegexBuilder.cs
+   .. input:: /includes/fundamentals/code-examples/specify-query/FindRegexBuilder.cs
       :language:  csharp
 
    .. output::
@@ -341,8 +330,6 @@ documents that have a value in the ``make`` field that starts with the letter
 
       { "_id" : 2, "make" : "Gibson", "models" : ["Les Paul", "SG", "Explorer"], "establishedYear" : 1902, "rating" : 8 }
 
-To learn more about using builders, see :ref:`csharp-builders`.
-
 Additional Information
 ----------------------
 
@@ -355,8 +342,6 @@ following Server Manual Entries:
 - :manual:`Element Query Operators </reference/operator/query-element/>`
 - :manual:`Evaluation Query Operators </reference/operator/query-evaluation/>`
 
-To learn more about using Builders, see :ref:`csharp-builders`.
-
 To learn how to specify queries using LINQ, see :ref:`csharp-linq`.
 
 .. TODO: integrate into existing page
diff --git a/source/crud/update-many.txt b/source/crud/update-many.txt
@@ -20,8 +20,8 @@ Update Many
 .. toctree::
    :caption: Update Documents
 
-   Fields </fundamentals/crud/write-operations/update-many/fields>
-   Arrays </fundamentals/crud/write-operations/update-many/arrays>
+   Fields </crud/update-many/fields>
+   Arrays </crud/update-many/arrays>
 
 .. include:: /includes/page-templates/update/update.rst
 
diff --git a/source/crud/update-one.txt b/source/crud/update-one.txt
@@ -20,8 +20,8 @@ Update One
 .. toctree::
    :caption: Update Documents
 
-   Fields </fundamentals/crud/write-operations/update-one/fields>
-   Arrays </fundamentals/crud/write-operations/update-one/arrays>
+   Fields </crud/update-one/fields>
+   Arrays </crud/update-one/arrays>
 
 .. include:: /includes/page-templates/update/update.rst
 
diff --git a/source/data-formats/custom-types.txt b/source/data-formats/custom-types.txt
@@ -0,0 +1,26 @@
+.. _csharp-custom-types:
+
+============
+Custom Types
+============
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: polymorphism, serialization, deserialization, poco 
+
+.. toctree::
+   :caption: Custom Types
+
+   Class Mapping </data-formats/custom-types/class-mapping>
+   POCOs </data-formats/custom-types/poco>
+   Polymorphic Objects </data-formats/custom-types/polymorphic-objects>
+   Serialization </data-formats/custom-types/serialization>
diff --git a/source/data-formats/custom-types/poco.txt b/source/data-formats/custom-types/poco.txt
@@ -728,9 +728,6 @@ Additional Information
 For a full list of serialization-related attributes, see the
 `Serialization.Attributes API documentation <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.Serialization.Attributes.html>`__.
 
-For additional read and write operation examples using POCOs, see the :ref:`Usage Examples
-<csharp-usage-examples>` or the :ref:`CRUD Fundamentals Pages <csharp-crud>`.
-
 To learn more about how the driver maps BSON documents to POCOs, see
 :ref:`csharp-class-mapping`.
 
diff --git a/source/data-formats/custom-types/serialization.txt b/source/data-formats/custom-types/serialization.txt
@@ -17,14 +17,6 @@ Serialization
    :depth: 2
    :class: singlecol
    
-.. toctree::
-   :caption: Serialization
-
-   Class Mapping </fundamentals/serialization/class-mapping>
-   POCOs </fundamentals/serialization/poco>
-   Polymorphic Objects </fundamentals/serialization/polymorphic-objects>
-   GUIDs </fundamentals/serialization/guid-serialization>
-
 Overview
 --------
 
diff --git a/source/data-formats/extended-json.txt b/source/data-formats/extended-json.txt
@@ -0,0 +1,11 @@
+.. _csharp-extended-json:
+
+=============
+Extended JSON
+=============
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
diff --git a/source/data-formats/time-series.txt b/source/data-formats/time-series.txt
@@ -90,7 +90,7 @@ Query a Time Series Collection
 ------------------------------
 
 To query a time series collection, follow the conventions for retrieving and aggregating
-data. For more information about these conventions, see the :ref:`csharp-retrieve` and
+data. For more information about these conventions, see the :ref:`csharp-find` and
 :ref:`csharp-aggregation` guides.
 
 Additional Information
diff --git a/source/databases-collections.txt b/source/databases-collections.txt
@@ -19,7 +19,7 @@ Databases and Collections
    :class: singlecol
 
 .. toctree::
-   /fundamentals/databases-collections/run-command
+   /run-command
 
 Overview
 --------
diff --git a/source/get-started.txt b/source/get-started.txt
@@ -239,9 +239,10 @@ and retrieves a document that matches a query.
 
 Learn more about the {+driver-short+} from the following resources:
 
-- Learn how to insert documents in the :ref:`<csharp-insert>` section.
-- Learn how to find documents in the :ref:`<csharp-query>` section.
-- Learn how to update documents in the :ref:`<csharp-update>` section.
-- Learn how to delete documents in the :ref:`<csharp-delete>` section.
+- Learn how to insert documents in the :ref:`<csharp-insert-guide>` section.
+- Learn how to find documents in the :ref:`<csharp-crud-query>` section.
+- Learn how to update documents in the :ref:`<csharp-update-one>` and
+  :ref:`<csharp-update-many>` sections.
+- Learn how to delete documents in the :ref:`<csharp-delete-guide>` section.
 
 .. include:: /includes/get-started/quickstart-troubleshoot.rst
diff --git a/source/index.txt b/source/index.txt
@@ -22,7 +22,7 @@ MongoDB C# Driver
    Indexes </indexes>
    Run a Database Command </run-command>
    Atlas Search </atlas-search>
-   Atlas Vector Search <https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-overview/>
+   Atlas Vector Search </atlas-vector-search>
    Logging and Monitoring </logging-and-monitoring>
    Security </security>
    Integrations </integrations>
diff --git a/source/integrations.txt b/source/integrations.txt
@@ -21,7 +21,7 @@ Integrations and Tools
 .. toctree::
    :maxdepth: 1
 
-   :ref:`OData <csharp-odata>`
+   OData </integrations/odata>
    Entity Framework Provider <https://www.mongodb.com/docs/entity-framework/current/>
    {+analyzer-short+} <https://www.mongodb.com/docs/mongodb-analyzer/>
 
diff --git a/source/issues-and-help.txt b/source/issues-and-help.txt
diff --git a/source/reference.txt b/source/reference.txt
@@ -14,6 +14,7 @@ Reference
 .. toctree::
 
    Quick Reference </reference/quick-reference>
+   Release Notes </reference/release-notes>
    Compatibility </reference/compatibility>
    Upgrade </reference/upgrade>
    Versions 2.0 to 2.18 </reference/previous-versions>
diff --git a/source/reference/quick-reference.txt b/source/reference/quick-reference.txt
diff --git a/source/reference/release-notes.txt b/source/reference/release-notes.txt
diff --git a/source/security.txt b/source/security.txt
diff --git a/source/security/authentication.txt b/source/security/authentication.txt

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. _csharp-retrieve:`
	`1`	`+.. _csharp-find:`
`2`	`2`
`3`	`3`	`=============`
`4`	`4`	`Retrieve Data`