fixes

Author: norareidy

snooty.toml

@@ -25,6 +25,7 @@ sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 driver-short = "PyMongo"
 driver-long = "PyMongo, the MongoDB synchronous Python driver,"
 driver-async = "PyMongo Async"
+django-odm = "MongoDB Backend for Django"
 language = "Python"
 mdb-server = "MongoDB Server"
 mongo-community = "MongoDB Community Edition"

source/configure-connection.txt

@@ -47,33 +47,44 @@ Manually Configure Database Settings
 To manually configure your connection to MongoDB, update
 the ``DATABASES`` setting in your project's ``settings.py``
 file. The ``DATABASES`` setting has a ``default`` key,
-which you must specify to set MongoDB as the default database
+which you must configure to set MongoDB as the default database
 connection.
 
-To specify the ``default`` key, include the following
-information:
+To configure the ``default`` key, include the following
+fields:
 
-- ``ENGINE``: The backend driver to use for the connection.
-  Set this field to ``"django_mongodb_backend"``.
+.. list-table::
+   :header-rows: 1
+   :widths: 20 80
 
-- ``HOST``: Your connection URI. For localhost connections,
-  this field is optional. For SRV connections, you must include
-  a scheme prefix (``mongodb+srv://``).
+   * - Field
+     - Description
 
-  If connecting to a replica set or sharded cluster with multiple hosts, specify
-  each host separated by a comma.
+   * - **ENGINE**
+     - The backend driver to use for the connection. Set this field to ``"django_mongodb_backend"``.
 
-- ``NAME``: The database you want to use.
+   * - **HOST**
+     - | Your connection URI. For localhost connections, this field is optional. 
+       | For SRV connections, you must include a scheme prefix (``mongodb+srv://``).
+       |
+       | If connecting to a replica set or sharded cluster with multiple hosts, specify 
+       | each host separated by a comma.
 
-- ``USER``: The username for authenticating to the database.
+   * - **NAME**
+     - The database you want to use.
 
-- ``PASSWORD``: The password for your database user.
+   * - **USER**
+     - The username for authenticating to the database.
 
-- ``PORT``: The port number on which the database server is listening.
-  For MongoDB Atlas connections, this field is optional.
+   * - **PASSWORD**
+     - The password for your database user.
 
-- ``OPTIONS``: A dictionary of additional connection options for the database.
-  This field is optional.
+   * - **PORT**
+     - | The port number on which the database server is listening. 
+       | For MongoDB Atlas connections, this field is optional.
+
+   * - **OPTIONS**
+     - A dictionary of additional connection options for the database. This field is optional.
 
 .. _django-manual-config-example:
 
@@ -83,8 +94,8 @@ Example
 This example specifies the ``DATABASES`` setting to connect
 to a MongoDB deployment with the following configuration:
 
-- Connects to the ``sample_db`` database
-- Provides authentication information for a user
+- Connects to the ``my_database`` database
+- Provides authentication information for a database user
   whose username is ``my_user`` and password is ``my_password``
 - Uses the default MongoDB port (``27017``)
 - Sets the ``retryWrites`` connection option to ``true``,
@@ -125,15 +136,15 @@ Automatically Configure Database Settings
 
 To automatically construct the ``DATABASES`` setting that configures
 your MongoDB connection, you can use the ``parse_uri()`` method. This
-method accepts the following parameters:
+method accepts the following arguments:
 
 - ``uri``: Your MongoDB connection URI.
 - ``conn_max_age``: Configures persistent database connections.
-  This parameter is optional. To learn more, see 
+  This argument is optional. To learn more, see 
   `Persistent connections <https://docs.djangoproject.com/en/stable/ref/databases/#persistent-database-connections>`__
   in the Django documentation.
 - ``test``: Provides a dictionary of settings for test
-  databases. This parameter is optional. To learn more, see 
+  databases. This argument is optional. To learn more, see 
   `the TEST setting <https://docs.djangoproject.com/en/stable/ref/settings/#test>`__
   in the Django documentation.
 
@@ -149,7 +160,7 @@ example:
 
     import django_mongodb_backend
 
-    MONGODB_URI = "mongodb+srv://my_user:[email protected]/myDatabase?retryWrites=true&w=majority"
+    MONGODB_URI = "mongodb+srv://my_user:[email protected]/my_database?retryWrites=true&w=majority"
     DATABASES["default"] = django_mongodb_backend.parse_uri(MONGODB_URI)
 
 Additional Information