TG feedback

Author: norareidy

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

@@ -64,13 +64,13 @@ you can create a Django project that connects to MongoDB.
       .. code-block:: bash
 
          DATABASES = {
-            "default": {
-               "ENGINE": "django_mongodb_backend",
-               "NAME": "sample_mflix",
-               "USER": "<username>",
-               "PASSWORD": "<password>",
-               "HOST": "<connection string URI>",
-            },
+             "default": {
+                 "ENGINE": "django_mongodb_backend",
+                 "NAME": "sample_mflix",
+                 "USER": "<username>",
+                 "PASSWORD": "<password>",
+                 "HOST": "<connection string URI>",
+             },
          }
 
       Replace the ``<username>`` and ``<password>`` placeholders with your

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

@@ -13,7 +13,7 @@ Create an Admin Site
 
 You can create a Django admin site to edit your application's 
 data from a web interface. To learn more about the Django admin
-site and its features, see `The Django admin site <https://docs.djangoproject.com/en/5.1/ref/contrib/admin/>`__
+site and its features, see `The Django admin site <https://docs.djangoproject.com/en/{+django-version-number+}/ref/contrib/admin/>`__
 in the Django documentation.
 
 .. procedure::

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/5.0.x.zip
+         python3 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
 
@@ -50,11 +50,12 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
 
          class Movie(models.Model):
             title = models.CharField(max_length=200)
-            plot = models.TextField(null=True)
+            plot = models.TextField(blank=True)
             runtime = models.IntegerField(default=0)
-            released = models.DateTimeField("release date", null=True)
+            released = models.DateTimeField("release date", null=True, blank=True)
             awards = EmbeddedModelField(Award)
-            genres = ArrayField(models.CharField(max_length=100), blank=True)
+            genres = ArrayField(models.CharField(max_length=100), null=True, blank=True)
+            objects = MongoManager()
 
             class Meta:
                db_table = "movies"
@@ -67,9 +68,6 @@ 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:
-               abstract = True
-
          class Viewer(models.Model):
             name = models.CharField(max_length=100)
             email = models.CharField(max_length=200)
@@ -108,14 +106,13 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
          def index(request):
             return HttpResponse("Hello, world. You're at the application index.")
 
-
          def recent_movies(request):
-            movies = Movie.objects.all().order_by('-released')[:5]
-            return render(request, 'recent_movies.html', {'movies': movies})
+            movies = Movie.objects.order_by("-released")[:5]
+            return render(request, "recent_movies.html", {"movies": movies})
 
          def viewers_list(request):
-            viewers = Viewer.objects.all().order_by('name')[:10]
-            return render(request, 'viewers_list.html', {'viewers': viewers})
+            viewers = Viewer.objects.order_by("name")[:10]
+            return render(request, "viewers_list.html", {"viewers": viewers})
 
       These views display a landing page message and information about your ``Movie``
       and ``Viewer`` models.
@@ -134,8 +131,8 @@ To learn more about the ``sample_mflix`` database, see :atlas:`Sample Mflix Data
 
          urlpatterns = [
             path("", views.index, name="index"),
-            path('recent_movies/', views.recent_movies, name='recent_movies'),
-            path('viewers_list/', views.viewers_list, name='viewers_list'),
+            path("recent_movies/", views.recent_movies, name="recent_movies"),
+            path("viewers_list/", views.viewers_list, name="viewers_list"),
          ]
 
       Then, navigate to the ``quickstart/urls.py`` file and replace its contents with

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

@@ -19,11 +19,8 @@ in your development environment.
 
    .. step:: Install the dependencies
 
-      Before installing {+django-odm+}, ensure you have the following dependencies installed
-      in your development environment:
-      
-      - `Python3 version 3.10 or later <https://www.python.org/downloads/>`__
-      - `pip <https://pip.pypa.io/en/stable/installation/>`__
+      Before installing {+django-odm+}, ensure you have `Python 3.10 or later <https://www.python.org/downloads/>`__
+      installed in your development environment.
 
    .. step:: Create a virtual environment
 
@@ -68,16 +65,6 @@ in your development environment.
       - PyMongo version {+version-number+} and its dependencies
       - Django version {+django-version-number+} and its dependencies
 
-      .. important::
-
-         If you have already installed PyMongo and Django in your
-         development environment, ensure that they fulfill the following
-         version requirements:
-
-         - PyMongo: Your version must be greater than or equal to 4.6 and less than 5.0.
-         - Django: Your version must be greater than or equal to 5.0 and less than 5.1.
-
-
 After you complete these steps, you have {+django-odm+} and its
 dependencies installed in your development environment.
 

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

@@ -19,20 +19,20 @@ to read data from the ``sample_mflix`` database.
 
    .. step:: Query the "users" collection for a specified email
 
-      Start a Python shell and import the required models
-      by running the following code:
+      Start a Python shell by running the following command:
 
       .. code-block:: bash
 
          python3 manage.py shell
-         from sample_mflix.models import Movie, Viewer
 
       Then, run the following code to query the 
       ``sample_mflix.users`` collection for a movie viewer whose email is 
       ``"[email protected]"``:
 
-      .. code-block:: bash
+      .. code-block:: python
 
+         from sample_mflix.models import Movie, Viewer
+         
          Viewer.objects.filter(email="[email protected]").first()
 
       This code returns the name of the matching user:
@@ -48,7 +48,7 @@ to read data from the ``sample_mflix`` database.
       collection for movies that have a ``runtime`` value less than
       ``10``:
 
-      .. code-block:: bash
+      .. code-block:: python
 
          Movie.objects.filter(runtime__lt=10)
 

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

@@ -31,7 +31,7 @@ and delete functions on your model objects.
    .. step:: Import the required classes and modules
 
       From your Python shell, run the following code to import
-      your models and the modules for creating a ``datetime`` object:
+      your models and the module for creating a ``datetime`` object:
 
       .. code-block:: python
 
@@ -47,11 +47,11 @@ and delete functions on your model objects.
 
       .. code-block:: python
 
-         movie_awards = Awards(wins=122, nominations=245, text="Won 1 Oscar")
+         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),
-         timezone.get_current_timezone()), awards=movie_awards, genres=["Drama", "Comedy"])
+         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: