edits

norareidy · norareidy · commit f3833c294ac8 · 2025-05-20T15:53:15.000-04:00
diff --git a/snooty.toml b/snooty.toml
@@ -21,12 +21,12 @@ toc_landing_pages = [
     "/reference/class/MongoDBModelDatabaseInfo",
     "/reference/class/MongoDBModelIndexInfo",
     "/connect",
-    "/databases-collections",
+    "/aggregation",
+    "/data-formats",
+    "/data-formats/custom-types",
     "/indexes",
     "/security",
-    "/data-formats",
     "/upgrade",
-    "/aggregation",
 ]
 
 sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
diff --git a/source/aggregation.txt b/source/aggregation.txt
@@ -18,13 +18,6 @@ Transform Your Data with Aggregation
    :depth: 2
    :class: singlecol
 
-.. toctree::
-   :titlesonly:
-   :maxdepth: 1
-
-   Atlas Search </aggregation/atlas-search>
-   Atlas Vector Search </aggregation/vector-search>
-
 Overview
 --------
 
diff --git a/source/atlas-search.txt b/source/atlas-search.txt
diff --git a/source/connect/connection-options.txt b/source/connect/connection-options.txt
@@ -18,8 +18,6 @@ Specify Connection Options
    :keywords: connection string, URI, server, Atlas, settings, configure
 
 .. toctree::
-   :titlesonly:
-   :maxdepth: 1
 
    Stable API </connect/connection-options/stable-api>
 
diff --git a/source/connect/connection-options/stable-api.txt b/source/connect/connection-options/stable-api.txt
diff --git a/source/crud.txt b/source/crud.txt
@@ -25,20 +25,24 @@ CRUD Operations
    Insert Documents </crud/insert>
    Query Documents </crud/query>
    Update Documents </crud/update>
+   Delete Documents </crud/replace>
    Delete Documents </crud/delete>
    Bulk Write Operations </crud/bulk-write>
    Transactions </crud/transaction>
    Configure CRUD Operations </crud/read-write-pref>
    Store Large Files </crud/gridfs>
+   Operations with Builders </crud/builders>
 
 CRUD (Create, Read, Update, Delete) operations enable you to work with
 data stored in MongoDB.
 
-- :ref:`php-insert`
+- :ref:`php-write-insert`
 - :ref:`php-query`
-- :ref:`php-update`
-- :ref:`php-delete`
+- :ref:`php-write-update`
+- :ref:`php-write-replace`
+- :ref:`php-write-delete`
 - :ref:`php-bulk-write`
 - :ref:`php-transactions`
 - :ref:`php-read-write-pref`
-- :ref:`php-gridfs`
+- :ref:`php-gridfs`
+- :ref:`php-builders`
diff --git a/source/crud/builders.txt b/source/crud/builders.txt
diff --git a/source/data-formats.txt b/source/data-formats.txt
@@ -22,9 +22,9 @@ Specialized Data Formats
    :maxdepth: 1
 
    Custom Data Types </data-formats/custom-types>
-   Codecs </data-formats/codecs>
    Decimal128 </data-formats/decimal128>
    BSON </data-formats/modeling-bson-data>
+   Time Series </data-formats/time-series>
 
 Overview
 --------
@@ -34,6 +34,5 @@ application. To learn how to work with these data formats, see the following
 guides:
 
 - :ref:`php-custom-types`
-- :ref:`php-codecs`
 - :ref:`php-decimal128`
 - :ref:`php-bson`
diff --git a/source/data-formats/custom-types.txt b/source/data-formats/custom-types.txt
@@ -4,6 +4,16 @@
 Custom Data-Types
 =================
 
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. toctree::
+   :maxdepth: 1
+
+   Codecs </data-formats/custom-types/codecs>
 
 .. note::
 
diff --git a/source/data-formats/custom-types/codecs.txt b/source/data-formats/custom-types/codecs.txt
@@ -4,7 +4,6 @@
 Codecs
 ======
 
-
 .. contents:: On this page
    :local:
    :backlinks: none
diff --git a/source/data-formats/time-series.txt b/source/data-formats/time-series.txt
@@ -196,7 +196,7 @@ following Server manual entries:
 - :manual:`Create and Query a Time Series Collection </core/timeseries/timeseries-procedures/>`
 - :manual:`Set Granularity for Time Series Data </core/timeseries/timeseries-granularity/>`
 
-To learn more about performing read operations, see :ref:`php-read`.
+To learn more about performing query operations, see :ref:`php-query`.
 
 To learn more about performing aggregation operations, see the :ref:`php-aggregation`
 guide.
diff --git a/source/databases-collections.txt b/source/databases-collections.txt
@@ -17,12 +17,6 @@ Databases and Collections
 .. meta::
    :keywords: table, row, organize, storage, code example
 
-.. toctree::
-   :titlesonly:
-   :maxdepth: 1
-
-   Time Series </databases-collections/time-series>
-
 Overview
 --------
 
diff --git a/source/index.txt b/source/index.txt
@@ -14,19 +14,18 @@ MongoDB PHP Library
    :titlesonly:
 
    Get Started </get-started>
-   Connect to MongoDB </connect>
+   Connect </connect>
    Databases & Collections </databases-collections>
    CRUD Operations </crud>
-   Operations with Builders </builders>
-   Run a Database Command </run-command>
-   Data Aggregation </aggregation>
+   Aggregation </aggregation>
+   Data Formats </data-formats>
    Indexes </indexes>
+   Run a Database Command </run-command>
+   Atlas Search </atlas-search>
+   Atlas Vector Search </atlas-vector-search>
    Monitoring and Logging </monitoring-logging>
    Security </security>
-   Specialized Data Formats </data-formats>
-   Compatibility </compatibility>
-   What's New </whats-new>
-   Upgrade </upgrade>
+   Reference </references>
    FAQ </faq>
    API Documentation </reference>
 
@@ -102,29 +101,17 @@ Secure Your Data
 Learn about ways you can authenticate your application and encrypt your data in
 the :ref:`php-security` section.
 
-Specialized Data Formats
-------------------------
+Data Formats
+------------
 
 Learn how to work with specialized data formats and custom types in the
 :ref:`php-data-formats` section.
 
-Compatibility
--------------
-
-See compatibility tables showing the recommended {+library-short+} version to use for
-specific PHP and {+mdb-server+} versions in the :ref:`php-compatibility` section.
+Reference
+---------
 
-What's New
-----------
-
-Learn about new features and changes in each version in the :ref:`<php-lib-whats-new>`
-section.
-
-Upgrade Library Versions
-------------------------
- 
-Learn what changes you must make to your application to upgrade library and
-extension versions in the :ref:`php-upgrade` section.
+Learn more about {+library-short+} versions, compatibility, and upgrade considerations in the
+:ref:`Reference <php-reference>` section.
 
 FAQ
 ---
diff --git a/source/references.txt b/source/references.txt
@@ -0,0 +1,17 @@
+.. _php-reference:
+
+=========
+Reference
+=========
+
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   Release Notes </references/release-notes>
+   Compatibility </references/compatibility>
+   Upgrade Guides </references/upgrade>
+
+- :ref:`php-release-notes`
+- :ref:`php-compatibility`
+- :ref:`php-upgrade`
diff --git a/source/references/compatibility.txt b/source/references/compatibility.txt
diff --git a/source/references/release-notes.txt b/source/references/release-notes.txt
@@ -1,8 +1,9 @@
 .. _php-lib-whats-new:
+.. _php-release-notes:
 
-==========
-What's New
-==========
+=============
+Release Notes
+=============
 
 .. facet::
    :name: genre
diff --git a/source/references/upgrade.txt b/source/references/upgrade.txt
diff --git a/source/vector-search.txt b/source/vector-search.txt
