(DOCSP-32333) Revamps database reference page to include Atlas UI steps (#4842) (#4905)

* (DOCSP-32333) Revamps database reference page to include Atlas UI steps

* Includes changes from copy review

* Fixes copy review issues

Author: sarahsimpers

source/reference/database-references.txt

@@ -12,7 +12,7 @@ Database References
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 1
+   :depth: 2
    :class: singlecol
 
 For many use cases in MongoDB, the denormalized data model where
@@ -32,6 +32,11 @@ or databases.
 This page outlines alternative procedures that predate the
 :pipeline:`$lookup` and :pipeline:`$graphLookup` pipeline stages.
 
+You can create a database reference for deployments hosted in the
+following environments:
+
+.. include:: /includes/fact-environments.rst
+
 MongoDB applications use one of two methods to relate documents:
 
 - :ref:`Manual references <document-references>` save the
@@ -72,8 +77,75 @@ A manual reference is the practice of including one
 application can then issue a second query to resolve the referenced
 fields as needed.
 
-Process
-~~~~~~~
+Create a Manual Reference in the {+atlas+} UI
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To create a manual reference in the {+atlas+} UI, follow these steps:
+
+.. procedure::
+   :style: normal
+
+   .. step:: Navigate to the collection.
+
+      a. In the {+atlas+} UI, click :guilabel:`Database` in the sidebar.
+      #. For the database deployment where you want to add a database
+         reference, click :guilabel:`Browse Collections`.
+      #. In the left navigation pane, select the database.
+      #. In the left navigation pane, select the collection. This
+         example references a ``places`` collection.
+
+   .. step:: Add a document.
+
+      a. Click :guilabel:`Insert Document`.
+      #. Click the JSON view icon (:guilabel:`{{}}`).
+      #. Paste the following data into the document:
+
+         .. code-block::
+
+            {
+              "_id": {
+                "$oid": "651aea5870299b120736f442"
+              },
+              "name": "Broadway Center",
+              "url": "bc.example.net"
+            }
+
+      #. Click :guilabel:`Insert`.
+
+   .. step:: Add a document in the ``people`` collection that references the entry in ``places``.
+
+      a. In the left navigation pane, select a different
+         collection. This example references a ``people`` collection.
+      #. Click :guilabel:`Insert Document`.
+      #. Click the JSON view icon (:guilabel:`{{}}`).
+      #. Paste the following data into the document:
+
+         .. code-block::
+
+            {
+              "_id": {
+                "$oid": "651aebeb70299b120736f443"
+              },
+              "name": "Erin",
+              "places_id": "651aea5870299b120736f442"
+              "url": "bc.example.net/Erin"
+            }
+
+      #. Click :guilabel:`Insert`.
+
+         When a query returns the document from the ``people``
+         collection you can, if needed, filter the query results from
+         the ``places`` collection for the document referenced by the
+         ``places_id`` field.
+
+         To learn more about running queries in {+atlas+},
+         see :atlas:`View, Filter, and Sort Documents 
+         </atlas-ui/documents/#view--filter--and-sort-documents>` in
+         the {+atlas+} documentation.
+
+
+Create a Manual Reference in the Terminal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Consider the following operation to insert two documents, using the
 ``_id`` field of the first document as a reference in the second