Apply suggestions from Sarah's review

cliff688 · sarahboyce · web-flow · commit b97ea85ff775 · 2025-07-24T17:57:14.000+02:00
Co-authored-by: Sarah Boyce &lt;42296566+sarahboyce@users.noreply.github.com&gt;
diff --git a/docs/ref/models/meta.txt b/docs/ref/models/meta.txt
@@ -38,8 +38,8 @@ Retrieving a single field instance of a model by name
     set by the user, the :attr:`~.ForeignKey.related_name` set by the user, or
     the name automatically generated by Django.
 
-    Hidden fields (:attr:`hidden=True <django.db.models.Field.hidden>`) cannot
-    be retrieved by name.
+    Hidden fields, fields with :attr:`hidden=True
+    <django.db.models.Field.hidden>`, cannot be retrieved by name.
 
     If a field with the given name is not found a
     :class:`~django.core.exceptions.FieldDoesNotExist` exception will be
@@ -80,7 +80,7 @@ Retrieving all field instances of a model
 
     ``include_hidden``
         ``False`` by default. If set to ``True``, ``get_fields()`` will include
-        fields with :attr:`hidden=True<django.db.models.Field.hidden>`.
+        fields with :attr:`hidden=True <django.db.models.Field.hidden>`.
 
     .. code-block:: pycon
 
@@ -129,9 +129,8 @@ Retrieving fields composing the primary key of a model
 
     Returns a list of the fields composing the primary key of a model.
 
-    When a :class:`~django.db.models.CompositePrimaryKey` is defined on a
-    model it will contain all the :doc:`fields </ref/models/fields>`
-    referenced by it.
+    When a :class:`~django.db.models.CompositePrimaryKey` is defined on a model
+    it will contain all the fields referenced by it.
 
     .. code-block:: python
 
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
@@ -463,10 +463,9 @@ A list of trusted origins for unsafe requests (e.g. ``POST``).
 For requests that include the ``Origin`` header, Django's CSRF protection
 requires that header match the origin present in the ``Host`` header.
 
-For a secure, unsafe request -- where "secure" is determined by
-:meth:`~django.http.HttpRequest.is_secure` -- that doesn't include the
-``Origin`` header, the request must include a ``Referer`` header that
-matches the origin in the ``Host`` header.
+For a secure (determined by :meth:`~django.http.HttpRequest.is_secure`) unsafe
+request that doesn't include the ``Origin`` header, the request must include a
+``Referer`` header that matches the origin in the ``Host`` header.
 
 These checks prevent, for example, a ``POST`` request from
 ``subdomain.example.com`` from succeeding against ``api.example.com``. If you
diff --git a/docs/topics/class-based-views/mixins.txt b/docs/topics/class-based-views/mixins.txt
@@ -161,7 +161,7 @@ To make a :class:`~django.template.response.TemplateResponse`,
 :class:`ListView` then uses
 :class:`~django.views.generic.list.MultipleObjectTemplateResponseMixin`;
 as with :class:`~django.views.generic.detail.SingleObjectTemplateResponseMixin`
-above, this implements
+above, this overrides
 :meth:`~django.views.generic.list.MultipleObjectTemplateResponseMixin.get_template_names`
 to provide a range of options with the most commonly-used being
 ``<app_label>/<model_name>_list.html``, with the ``_list`` part again
diff --git a/docs/topics/db/optimization.txt b/docs/topics/db/optimization.txt
@@ -378,7 +378,7 @@ number of SQL queries. For example::
     Entry.objects.create(headline="This is only a test")
 
 Note that :meth:`~django.db.models.query.QuerySet.bulk_create` has several
-caveats (see its documentation), so ensure it's appropriate for your use case.
+caveats, so ensure it's appropriate for your use case.
 
 Update in bulk
 --------------
diff --git a/docs/topics/db/queries.txt b/docs/topics/db/queries.txt
@@ -1372,7 +1372,7 @@ Keyword argument queries -- in :meth:`~django.db.models.query.QuerySet.filter`,
 etc. -- are "AND"ed together. If you need to execute more complex queries (for
 example, queries with ``OR`` statements), you can use :ref:`q-objects`.
 
-A :class:`~django.db.models.Q` object (``django.db.models.Q``) is an object
+A :ref:`Q object <q-objects>` (``django.db.models.Q``) is an object used to
 used to encapsulate a collection of keyword arguments. These keyword arguments
 are specified as in "Field lookups" above.
 
diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt
@@ -298,7 +298,7 @@ Considerations regarding model's ``error_messages``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Error messages defined at the form field level (
-:attr:`django.forms.Field.error_messages`) level or at the
+:attr:`django.forms.Field.error_messages`) or at the
 :ref:`form Meta <modelforms-overriding-default-fields>` level always take
 precedence over the error messages defined at the model field level
 (:attr:`django.db.models.Field.error_messages`).
