DOCSP-42732: qs

snooty.toml

@@ -1,8 +1,16 @@
 name = "mongoid"
 title = "Mongoid"
 
-intersphinx = ["https://www.mongodb.com/docs/manual/objects.inv"]
+intersphinx = [ "https://www.mongodb.com/docs/manual/objects.inv",
+                "https://www.mongodb.com/docs/atlas/objects.inv"
+              ]
+
+toc_landing_pages = [
+    "/quick-start"
+    ]
 
 [constants]
 rails-6-version = 6.0
 rails-7-version = 7.1
+odm = "Mongoid"
+ruby-driver = "Ruby driver"

source/index.txt

@@ -1,18 +1,18 @@
-.. _mongoid:
+.. _mongoid-odm:
 
-*******
-Mongoid
-*******
+=======
+{+odm+}
+=======
 
-.. default-domain:: mongodb
-
-Mongoid is the officially supported object-document mapper (ODM) for MongoDB in
-Ruby. To work with Mongoid from the command line using ``rails``-like tooling,
-the `railsmdb <https://github.com/mongodb/mongoid-railsmdb>`_ utility can be used.
+{+odm+} is the officially supported object-document mapper (ODM) for
+MongoDB in Ruby. To work with {+odm+} from the command line using
+``rails``-like tooling, you can use the `railsmdb
+<https://github.com/mongodb/mongoid-railsmdb>`_ utility.
 
 .. toctree::
   :titlesonly:
 
+  /quick-start
   installation-configuration
   tutorials
   schema-configuration

source/quick-start.txt

@@ -0,0 +1,58 @@
+.. _mongoid-quick-start:
+
+===========
+Quick Start
+===========
+
+.. facet::
+   :name: genre
+   :values: tutorial
+
+.. meta::
+   :keywords: php framework, odm
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Overview
+--------
+
+This guide shows you how to use {+odm+} in a new web application,
+connect to a MongoDB cluster hosted on MongoDB Atlas, and perform
+read and write operations on the data in your cluster.
+
+.. tip::
+
+   If you prefer to connect to MongoDB by using the {+ruby-driver+} without
+   {+odm+}, see the {+ruby-driver+} :ruby:`Quick Start guide
+   </tutorials/quick-start/>`.
+
+{+odm+} is an Object-Document Mapper (ODM) framework for MongoDB in
+Ruby. By using {+odm+}, you can easily interact with your data and
+create flexible data models.
+
+MongoDB Atlas is a fully managed cloud database service that hosts your
+MongoDB deployments. You can create your own free (no credit card
+required) MongoDB Atlas deployment by following the steps in this guide.
+
+Follow the steps in this guide to create a sample {+odm+} web application
+that connects to a MongoDB deployment.
+
+.. TODO .. tip::
+.. 
+..    You can download the complete web application project by cloning the
+..    `mongoid-quickstart <>`__ GitHub repository.
+
+.. toctree::
+
+   /quick-start/download-and-install/
+
+..    /quick-start/create-a-deployment/
+..    /quick-start/create-a-connection-string/
+..    /quick-start/configure-mongodb/
+..    /quick-start/view-data/
+..    /quick-start/write-data/
+..    /quick-start/next-steps/