more wording changes

Author: norareidy

source/django-get-started/django-connect-mongodb.txt

@@ -14,6 +14,9 @@ Configure your MongoDB Connection
 .. procedure::
    :style: connected
 
+   After installing {+django-odm+} and creating a MongoDB Atlas deployment,
+   you can create a Django project that connects to MongoDB.
+
    .. step:: Create a Django project
 
       From your shell, run the following command to create a 

source/django-get-started/django-connection-string.txt

@@ -19,7 +19,7 @@ To connect to an instance or deployment not hosted on Atlas, see
 .. procedure::
    :style: connected
 
-   .. step:: Find your MongoDB Atlas Connection String
+   .. step:: Find your MongoDB Atlas connection string
 
       To retrieve your connection string for the deployment that
       you created in the :ref:`previous step <django-get-started-create-deployment>`,
@@ -35,15 +35,15 @@ To connect to an instance or deployment not hosted on Atlas, see
       that best matches the version you installed from the :guilabel:`Version`
       selection menu.
 
-   .. step:: Copy your Connection String
+   .. step:: Copy your connection string
 
       Click the button on the right of the connection string to copy it to
       your clipboard as shown in the following screenshot:
 
       .. figure:: /includes/figures/atlas_connection_copy_string_python.png
          :alt: The connection string copy button in the Atlas UI
 
-   .. step:: Update the Placeholders
+   .. step:: Update the placeholders
 
       Paste this connection string into a file in your preferred text editor
       and replace the ``<username>`` and ``<password>`` placeholders with

source/django-get-started/django-create-app.txt

@@ -14,6 +14,16 @@ Create an Application
 .. procedure::
    :style: connected
 
+   In your ``quickstart`` project, you can create an application
+   that interacts with the Atlas sample database called ``sample_mflix``.
+   This database contains a ``movies`` collection, which stores
+   information about movies. The database also contains a ``users``
+   collection, which stores information about movie viewers who use 
+   a streaming service.
+
+   To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Dataset
+   </sample-data/sample-mflix/>` in the Atlas documentation.
+
    .. step:: Create a "sample_mflix" app
 
       From your project's root directory, run the following command to create a 
@@ -78,8 +88,7 @@ Create an Application
       a list of genres that describe the movie.
 
       The ``Award`` model does not represent a separate collection. Instead, it 
-      represents the embedded document values that the ``awards``
-      field of the ``Movie`` model stores.
+      represents the embedded document values stored in the ``Movie`` model.
 
       The ``Viewer`` model represents the ``sample_mflix.users`` collection
       and stores account credentials for movie viewers.
@@ -243,4 +252,4 @@ Create an Application
          python3 manage.py migrate
 
 After completing these steps, you have a basic {+django-odm+} app that
-you can use to interact with the ``sample_mflix`` database.
+you can use to access the ``sample_mflix`` Atlas database.

source/django-get-started/django-create-deployment.txt

@@ -11,14 +11,14 @@ your MongoDB database in the cloud.
 .. procedure::
    :style: connected
 
-   .. step:: Create a Free MongoDB deployment on Atlas
+   .. step:: Create a free MongoDB deployment on Atlas
 
       Complete the :atlas:`Get Started with Atlas </getting-started?tck=docs_driver_python>`
       guide to set up a new Atlas account and a free tier MongoDB deployment.
       Ensure that you **load sample data** and **add your IP address** to the IP access
       list.
 
-   .. step:: Save your Credentials
+   .. step:: Save your credentials
 
       After you create your database user, save that user's 
       username and password to a safe location for use in an upcoming step.

source/django-get-started/django-install.txt

@@ -14,7 +14,7 @@ Download and Install
 .. procedure::
    :style: connected
 
-   .. step:: Install Dependencies
+   .. step:: Install the dependencies
 
       Before installing {+django-odm+}, ensure you have the following dependencies installed
       in your development environment:

source/django-get-started/django-query-data.txt

@@ -11,6 +11,9 @@ Query MongoDB Data
 .. meta::
    :keywords: app, odm, code example
 
+You can use the Python interactive shell and your
+models to read data from the ``sample_mflix`` database.
+
 .. procedure::
    :style: connected
 

source/django-get-started/django-write-data.txt

@@ -11,6 +11,11 @@ Write Data to MongoDB
 .. meta::
    :keywords: app, odm, code example
 
+You can use your application's models to update documents
+stored in the ``sample_mflix`` database. To update documents,
+enter the Python interactive shell and call create, update,
+and delete functions on your model objects.
+
 .. procedure::
    :style: connected
 
@@ -58,7 +63,7 @@ Write Data to MongoDB
    .. step:: Update your movie object
 
       The ``Movie`` object created in the previous step has inaccurate data:
-      the ``runtime`` value is ``217``, but the correct ``runtime`` is ``117``.
+      the ``runtime`` value is ``217``, but the correct ``runtime`` value is ``117``.
 
       Run the following code to update the object's ``runtime`` value:
 
@@ -71,7 +76,7 @@ Write Data to MongoDB
 
       You can also use your ``Viewer`` model to insert documents into the
       ``sample_mflix.users`` collection. Run the following code to create
-      a ``Viewer`` object that stores data about a user named ``"Abigail Carter"``:
+      a ``Viewer`` object that stores data about a movie viewer named ``"Abigail Carter"``:
 
       .. code-block:: python
 
@@ -113,14 +118,14 @@ Write Data to MongoDB
 
    .. step:: Render your new objects
 
-      To ensure that your ``Movie`` object was inserted into the database,
+      To ensure that you inserted a ``Movie`` object into the database,
       visit the http://127.0.0.1:8000/sample_mflix/recent_movies/ URL.
-      You should see a list of five movies in the ``sample_mflix.movies``
+      You can see a list of five movies in the ``sample_mflix.movies``
       database, with your new movie listed at the top.
 
-      Then, ensure that your ``Viewer`` object was inserted into the
+      Then, ensure that you inserted a ``Viewer`` object into the
       database by visiting the http://127.0.0.1:8000/sample_mflix/viewers_list/
-      URL. You should see a list of ten viewer names in the ``sample_mflix.users``
+      URL. You can see a list of ten viewer names in the ``sample_mflix.users``
       database, with your new viewer listed at the top. Ensure that the
       viewer named "Alliser Thorne", deleted in a previous step, does not appear
       in this list.