TG feedback 2

Author: norareidy

snooty.toml

@@ -26,7 +26,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"
+django-odm = "Django MongoDB Backend"
 django-api = "https://django-mongodb.readthedocs.io/en/latest/"
 language = "Python"
 mdb-server = "MongoDB Server"

source/django-get-started.txt

@@ -30,10 +30,9 @@ Get Started with {+django-odm+}
    Create an Admin Site </django-get-started/django-create-admin/>
    Next Steps </django-get-started/django-next-steps/>
 
-{+django-odm+} is a PyMongo integration that allows you to use the
-MongoDB document model in your Django application. This tutorial shows
-you how to create a Django app, connect to MongoDB cluster hosted on
-MongoDB Atlas, and interact with data in your cluster.
+{+django-odm+} is a Django database backend that uses PyMongo to connect
+to MongoDB. This tutorial shows you how to create a Django app, connect to
+a MongoDB cluster hosted on MongoDB Atlas, and interact with data in your cluster.
 
 .. tip:: 
 

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

@@ -61,7 +61,7 @@ you can create a Django project that connects to MongoDB.
       Open your ``settings.py`` file and navigate to the ``DATABASES`` setting.
       Replace this setting with the following code:
 
-      .. code-block:: bash
+      .. code-block:: python
 
          DATABASES = {
             "default": django_mongodb_backend.parse_uri("<connection string URI>"),
@@ -79,7 +79,7 @@ you can create a Django project that connects to MongoDB.
 
       .. code-block:: bash
 
-         python3 manage.py runserver
+         python manage.py runserver
 
       Then, visit http://127.0.0.1:8000/. This page displays a "Congratulations!"
       message and an image of a rocket. 

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

@@ -66,5 +66,4 @@ To connect to an instance or deployment not hosted on Atlas, see
          mongodb+srv://<username>:<password>@cluster0.example.mongodb.net/sample_mflix?retryWrites=true&w=majority
 
 After completing these steps, you have a connection string that
-contains your database username, database password, and database name.
-
+contains your database username, database password, and database name.

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

@@ -29,7 +29,7 @@ in the Django documentation.
 
       .. code-block:: bash
 
-         python3 manage.py createsuperuser
+         python manage.py createsuperuser
 
       Then, your terminal prompts you for a username, email address,
       and password. For each prompt, enter the following information
@@ -51,7 +51,7 @@ in the Django documentation.
 
       .. code-block:: bash
 
-         python3 manage.py runserver
+         python manage.py runserver
 
       Once your server is running, visit the http://127.0.0.1:8000/admin/ 
       URL to see the admin site. This site displays the following login

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

@@ -31,7 +31,7 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
 
       .. code-block:: bash
 
-         python3 manage.py startapp sample_mflix --template https://github.com/mongodb-labs/django-mongodb-app/archive/refs/heads/{+django-version-number+}.x.zip
+         python manage.py startapp sample_mflix --template https://github.com/mongodb-labs/django-mongodb-app/archive/refs/heads/{+django-version-number+}.x.zip
 
       .. note:: App Template
 
@@ -58,6 +58,7 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
 
              class Meta:
                  db_table = "movies"
+                 managed = False
 
              def __str__(self):
                  return self.title
@@ -67,13 +68,17 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
              nominations = models.IntegerField(default=0)
              text = models.CharField(max_length=100)
 
+             class Meta:
+                 managed = False
+
          class Viewer(models.Model):
              name = models.CharField(max_length=100)
              email = models.CharField(max_length=200)
              password = models.CharField(max_length=100)
 
              class Meta:
                  db_table = "users"
+                 managed = False
 
              def __str__(self):
                  return self.name
@@ -153,7 +158,7 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
       ``templates``. Then, create a file called ``recent_movies.html``
       and paste the following code:
 
-      .. code-block:: python
+      .. code-block:: html
 
          <!-- templates/recent_movies.html -->
          <!DOCTYPE html>
@@ -182,7 +187,7 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
       Create another file in the ``sample_mflix/templates`` directory called
       ``viewers_list.html`` and paste the following code:
 
-      .. code-block:: python
+      .. code-block:: html
 
          <!-- templates/viewers_list.html -->
          <!DOCTYPE html>
@@ -244,8 +249,8 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
 
       .. code-block:: bash
 
-         python3 manage.py makemigrations sample_mflix
-         python3 manage.py migrate
+         python manage.py makemigrations sample_mflix
+         python manage.py migrate
 
 After completing these steps, you have a basic {+django-odm+} app that
 you can use to access the ``sample_mflix`` Atlas database.

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

@@ -34,21 +34,21 @@ in your development environment.
 
              .. code-block:: bash
 
-                python3 -m venv venv
+                python -m venv venv
                 source venv/bin/activate
 
           .. tab:: Windows
              :tabid: windows-venv
 
              .. code-block:: bash
 
-                python3 -m venv venv
+                python -m venv venv
                 . venv\Scripts\activate
 
       .. tip::
 
          In the preceding commands, you might need to replace
-         ``python3`` with the command that points to your Python
+         ``python`` with the command that points to your Python
          3.10+ interpreter.
 
    .. step:: Install {+django-odm+}
@@ -63,9 +63,7 @@ in your development environment.
       This command also installs the following dependencies:
 
       - PyMongo version {+version-number+} and its dependencies
-      - Django version {+django-version-number+} and its dependencies
+      - Latest Django {+django-version-number+}.x version and its dependencies
 
 After you complete these steps, you have {+django-odm+} and its
-dependencies installed in your development environment.
-
-
+dependencies installed in your development environment.

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

@@ -23,7 +23,7 @@ to read data from the ``sample_mflix`` database.
 
       .. code-block:: bash
 
-         python3 manage.py shell
+         python manage.py shell
 
       Then, run the following code to query the 
       ``sample_mflix.users`` collection for a movie viewer whose email is 

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

@@ -26,7 +26,7 @@ and delete functions on your model objects.
 
       .. code-block:: bash
 
-         python3 manage.py shell
+         python manage.py shell
 
    .. step:: Import the required classes and modules
 
@@ -48,17 +48,14 @@ and delete functions on your model objects.
       .. code-block:: python
 
          movie_awards = Award(wins=122, nominations=245, text="Won 1 Oscar")
-         movie = Movie(title="Minari", plot=
-         "A Korean-American family moves to an Arkansas farm in search of their own American Dream",
-         runtime=217, released=timezone.make_aware(datetime(2020, 1, 26, 0, 0)),
-         awards=movie_awards, genres=["Drama", "Comedy"])
-
-      Save the object to store its data as a document in the ``movies``
-      collection, as shown in the following code:
-
-      .. code-block:: python
-         
-         movie.save()
+         movie = Movie.objects.create(
+             title="Minari",
+             plot="A Korean-American family moves to an Arkansas farm in search of their own American Dream",
+             runtime=217,
+             released=timezone.make_aware(datetime(2020, 1, 26)),
+             awards=movie_awards,
+             genres=["Drama", "Comedy"]
+         )
 
    .. step:: Update your movie object
 
@@ -79,16 +76,12 @@ and delete functions on your model objects.
       a ``Viewer`` object that stores data about a movie viewer named ``"Abigail Carter"``:
 
       .. code-block:: python
-         
-         viewer = Viewer(name="Abigail Carter", email="[email protected]",
-         password="secure123")
-
-      Save the object to store its data as a document in the ``users``
-      collection, as shown in the following code:
 
-      .. code-block:: python
-         
-         viewer.save()
+         viewer = Viewer.objects.create(
+             name="Abigail Carter",
+             email="[email protected]",
+             password="secure123"
+         )
 
    .. step:: Delete a viewer object
 
@@ -114,7 +107,7 @@ and delete functions on your model objects.
 
       .. code-block:: bash
 
-         python3 manage.py runserver
+         python manage.py runserver
 
    .. step:: Render your new objects