DOCSP-51035: parse_uri() options

Author: norareidy

source/connect.txt

@@ -144,8 +144,10 @@ function accepts the following arguments:
 
 - ``uri``: Your MongoDB connection URI.
 - ``db_name``: The name of the database you want to use.
-- ``test``: Provides a dictionary of settings for test
-  databases. This argument is optional. To learn more, see
+- ``options``: *(Optional)* A dictionary of options to apply to the connection.
+   These options take precedence over any duplicate options specified in the URI.
+- ``test``: *(Optional)* Provides a dictionary of settings for test
+  databases. To learn more, see
   `the TEST setting <{+django-docs+}/ref/settings/#test>`__
   in the {+framework+} documentation.
 
@@ -160,8 +162,12 @@ example:
 
     import django_mongodb_backend
 
-    MONGODB_URI = "mongodb+srv://my_user:[email protected]/?retryWrites=true&w=majority"
-    DATABASES["default"] = django_mongodb_backend.parse_uri(MONGODB_URI, db_name="<database name>")
+    MONGODB_URI = "mongodb+srv://my_user:[email protected]/"
+    DATABASES["default"] = django_mongodb_backend.parse_uri(
+      MONGODB_URI,
+      db_name="<database name>",
+      options={"retryWrites": "true", "w": "majority"}
+    )
 
 Additional Information
 ----------------------