mongodb · norareidy · Dec 6, 2024 · Dec 5, 2024 · Dec 5, 2024 · Dec 5, 2024
diff --git a/source/index.txt b/source/index.txt
@@ -1,59 +1,119 @@
-.. _ruby-language-center:
+====================
+{+driver-long+}
+====================
 
-*******************
-Ruby MongoDB Driver
-*******************
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: twocols
 
-.. class:: hidden
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   View the Source <https://github.com/mongodb/mongo-ruby-driver>
+   API Documentation <{+api-root+}>
 
-  .. toctree::
-    :titlesonly:
+.. TODO:
+ Get Started </get-started>
+ Connect </connect>
+ Databases & Collections </databases-collections>
+ Read Data </read>
+ Write Data </write>
+ Operations on Replica Sets </read-write-pref>
+ Indexes </indexes>
+ Monitor Your Application </monitoring>
+ Data Aggregation </aggregation>
+ Security </security>
+ Issues & Help </issues-and-help>
+ What's New </whats-new>
+ Upgrade </upgrade>
+ Compatibility </compatibility>
 
-    Get Started <getting-started>
-    Connect to MongoDB <connect>
-    Tutorials <tutorials>
-    Connection & Configuration <reference/connection-and-configuration>
-    Working with Data <reference/working-with-data>
-    Schema Operations <reference/schema-operations>
-    API <https://mongodb.com/docs/ruby-driver/current/api/>
-    Release Notes <release-notes>
-    Additional Resources <reference/additional-resources>
-    Contribute <contribute>
+Introduction
+------------
 
-Welcome to the documentation site for the official MongoDB Ruby driver.
-You can add the driver to your application to work with MongoDB in
-Ruby.
+Welcome to the documentation site for the {+driver-long+}, the official
+MongoDB driver for {+language+} applications.
 
-Get Started
-===========
+.. TODO:
+.. Get Started
+.. -----------
 
-To get started with the Ruby driver, see :doc:`/installation` and
-:doc:`/tutorials/quick-start`. Continue to :doc:`/tutorials`
-for high level documentation for common operations.
+.. Learn how to install the driver, establish a connection to MongoDB, and begin
+.. working with data in the :ref:`ruby-get-started` tutorial.
 
-BSON
-====
+.. Connect to MongoDB
+.. ------------------
 
-The Ruby BSON implementation is packaged in a separate gem with C and
-Java extensions for speed depending on the runtime environment.
+.. Learn how to create and configure a connection to a MongoDB deployment
+.. in the :ref:`ruby-connect` section.
 
-For reference on the Ruby BSON gem, see the :doc:`/tutorials/bson`.
+.. Databases and Collections
+.. -------------------------
 
-Object Mappers
-==============
+.. Learn how to use the {+driver-short+} to work with MongoDB databases and collections in the
+.. :ref:`ruby-databases-collections` section.
 
-Because MongoDB is so easy to use, the basic Ruby driver can be the
-best solution for many applications. But if you need validations,
-associations, and other high-level data modeling functions, then you
-may need Object Document Mapper.
+.. Read Data from MongoDB
+.. ----------------------
 
-In the context of a Rails application, an Object Document Mapper
-provides functionality equivalent to, but distinct from, ActiveRecord.
-Because MongoDB is a document-based database, these mappers are called
-Object Document Mappers (ODM) as opposed to Object Relational Mappers
-(ORM).
+.. Learn how you can retrieve data from MongoDB in the :ref:`ruby-read` section.
 
-The ODM officially supported by MongoDB is Mongoid, originally written
-by Durran Jordan.
+.. Write Data to MongoDB
+.. ---------------------
 
-For tutorials on Mongoid, see the `Mongoid Manual <https://mongodb.com/docs/mongoid/master>`_.
+.. Learn how you can write data to MongoDB in the :ref:`ruby-write` section.
+
+.. Configure Operations on Replica Sets
+.. ------------------------------------
+
+.. Learn how to configure read and write operations on a replica set in the
+.. :ref:`ruby-read-write-pref` section.
+
+.. Optimize Queries by Using Indexes
+.. ---------------------------------
+
+.. Learn how to work with common types of indexes in the :ref:`ruby-indexes`
+.. section.
+
+.. Transform Your Data with Aggregation
+.. ------------------------------------
+
+.. Learn how to use the {+driver-short+} to perform aggregation operations in the
+.. :ref:`ruby-aggregation` section.
+
+.. Secure Your Data
+.. ----------------
+
+.. Learn how to authenticate your application and encrypt your data in the
+.. :ref:`ruby-security` section.
+
+.. What's New
+.. ----------
+
+.. For a list of new features and changes in each version, see the :ref:`What's New <ruby-whats-new>`
+.. section.
+
+.. Upgrade Driver Versions
+.. -----------------------
+
+.. Learn what changes you must make to your application to upgrade driver
+.. versions in the :ref:`ruby-upgrade` section.
+
+.. Compatibility
+.. -------------
+
+.. To learn about the versions of the {+mdb-server+} and the {+language+} language
+.. that are compatible with  each version of the {+driver-short+}, see the
+.. :ref:`Compatibility <ruby-compatibility>` section.
+
+Developer Hub
+-------------
+
+The Developer Hub provides tutorials and social engagement for
+developers.
+
+To ask questions and engage in discussions with fellow developers who
+use the {+driver-short+}, see the `forums page. <https://www.mongodb.com/community/forums/tag/ruby>`__
diff --git a/source/contribute.txt → source/old-content/contribute.txt b/source/contribute.txt → source/old-content/contribute.txt
diff --git a/source/getting-started.txt → source/old-content/getting-started.txt b/source/getting-started.txt → source/old-content/getting-started.txt
diff --git a/source/installation.txt → source/old-content/installation.txt b/source/installation.txt → source/old-content/installation.txt
diff --git a/source/reference/additional-resources.txt → ...ontent/reference/additional-resources.txt b/source/reference/additional-resources.txt → ...ontent/reference/additional-resources.txt
diff --git a/source/reference/aggregation.txt → source/old-content/reference/aggregation.txt b/source/reference/aggregation.txt → source/old-content/reference/aggregation.txt
diff --git a/source/reference/authentication.txt → .../old-content/reference/authentication.txt b/source/reference/authentication.txt → .../old-content/reference/authentication.txt
diff --git a/source/reference/bulk-operations.txt → ...old-content/reference/bulk-operations.txt b/source/reference/bulk-operations.txt → ...old-content/reference/bulk-operations.txt
diff --git a/source/reference/change-streams.txt → .../old-content/reference/change-streams.txt b/source/reference/change-streams.txt → .../old-content/reference/change-streams.txt
diff --git a/source/reference/collations.txt → source/old-content/reference/collations.txt b/source/reference/collations.txt → source/old-content/reference/collations.txt
diff --git a/source/reference/collection-tasks.txt → ...ld-content/reference/collection-tasks.txt b/source/reference/collection-tasks.txt → ...ld-content/reference/collection-tasks.txt
diff --git a/...eference/connection-and-configuration.txt → ...eference/connection-and-configuration.txt b/...eference/connection-and-configuration.txt → ...eference/connection-and-configuration.txt
diff --git a/source/reference/create-client.txt → ...e/old-content/reference/create-client.txt b/source/reference/create-client.txt → ...e/old-content/reference/create-client.txt
diff --git a/source/reference/crud-operations.txt → ...old-content/reference/crud-operations.txt b/source/reference/crud-operations.txt → ...old-content/reference/crud-operations.txt
@@ -93,7 +93,7 @@ Specify a ``Decimal128`` number
 .. versionadded:: 3.4
 
 :manual:`Decimal128</tutorial/model-monetary-data>` is a
-:doc:`BSON datatype </tutorials/bson>`
+:ref:`BSON datatype <ruby-bson-tutorial>`
 that employs 128-bit decimal-based floating-point values capable
 of emulating decimal rounding with exact precision. This
 functionality is intended for applications that handle

diff --git a/source/reference/database-tasks.txt → .../old-content/reference/database-tasks.txt b/source/reference/database-tasks.txt → .../old-content/reference/database-tasks.txt
diff --git a/source/reference/driver-compatibility.txt → ...ontent/reference/driver-compatibility.txt b/source/reference/driver-compatibility.txt → ...ontent/reference/driver-compatibility.txt
diff --git a/source/reference/geospatial-search.txt → ...d-content/reference/geospatial-search.txt b/source/reference/geospatial-search.txt → ...d-content/reference/geospatial-search.txt
diff --git a/source/reference/gridfs.txt → source/old-content/reference/gridfs.txt b/source/reference/gridfs.txt → source/old-content/reference/gridfs.txt
diff --git a/source/reference/in-use-encryption.txt → ...d-content/reference/in-use-encryption.txt b/source/reference/in-use-encryption.txt → ...d-content/reference/in-use-encryption.txt
diff --git a/...use-encryption/client-side-encryption.txt → ...use-encryption/client-side-encryption.txt b/...use-encryption/client-side-encryption.txt → ...use-encryption/client-side-encryption.txt
diff --git a/...n-use-encryption/queryable-encryption.txt → ...n-use-encryption/queryable-encryption.txt b/...n-use-encryption/queryable-encryption.txt → ...n-use-encryption/queryable-encryption.txt
diff --git a/source/reference/indexing.txt → source/old-content/reference/indexing.txt b/source/reference/indexing.txt → source/old-content/reference/indexing.txt
diff --git a/source/reference/map-reduce.txt → source/old-content/reference/map-reduce.txt b/source/reference/map-reduce.txt → source/old-content/reference/map-reduce.txt
diff --git a/source/reference/monitoring.txt → source/old-content/reference/monitoring.txt b/source/reference/monitoring.txt → source/old-content/reference/monitoring.txt
diff --git a/source/reference/projection.txt → source/old-content/reference/projection.txt b/source/reference/projection.txt → source/old-content/reference/projection.txt
diff --git a/source/reference/query-cache.txt → source/old-content/reference/query-cache.txt b/source/reference/query-cache.txt → source/old-content/reference/query-cache.txt
diff --git a/source/reference/schema-operations.txt → ...d-content/reference/schema-operations.txt b/source/reference/schema-operations.txt → ...d-content/reference/schema-operations.txt
diff --git a/source/reference/search-indexes.txt → .../old-content/reference/search-indexes.txt b/source/reference/search-indexes.txt → .../old-content/reference/search-indexes.txt
diff --git a/source/reference/sessions.txt → source/old-content/reference/sessions.txt b/source/reference/sessions.txt → source/old-content/reference/sessions.txt
diff --git a/source/reference/text-search.txt → source/old-content/reference/text-search.txt b/source/reference/text-search.txt → source/old-content/reference/text-search.txt
diff --git a/source/reference/transactions.txt → ...ce/old-content/reference/transactions.txt b/source/reference/transactions.txt → ...ce/old-content/reference/transactions.txt
diff --git a/source/reference/user-management.txt → ...old-content/reference/user-management.txt b/source/reference/user-management.txt → ...old-content/reference/user-management.txt
diff --git a/source/reference/working-with-data.txt → ...d-content/reference/working-with-data.txt b/source/reference/working-with-data.txt → ...d-content/reference/working-with-data.txt
diff --git a/source/release-notes.txt → source/old-content/release-notes.txt b/source/release-notes.txt → source/old-content/release-notes.txt
diff --git a/source/support.txt → source/old-content/support.txt b/source/support.txt → source/old-content/support.txt
diff --git a/source/tutorials.txt → source/old-content/tutorials.txt b/source/tutorials.txt → source/old-content/tutorials.txt
diff --git a/source/tutorials/bson.txt → source/old-content/tutorials/bson.txt b/source/tutorials/bson.txt → source/old-content/tutorials/bson.txt
diff --git a/source/tutorials/common-errors.txt → ...e/old-content/tutorials/common-errors.txt b/source/tutorials/common-errors.txt → ...e/old-content/tutorials/common-errors.txt
diff --git a/source/tutorials/quick-start.txt → source/old-content/tutorials/quick-start.txt b/source/tutorials/quick-start.txt → source/old-content/tutorials/quick-start.txt