upgrade docs deps + fix inconsistencies

Author: bagerard

docs/Makefile

@@ -40,9 +40,8 @@ html:
 
 html-readthedocs:
 	$(SPHINXBUILD) -T -E -b readthedocs $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
+	@echo "Open in browser: file://`realpath $(BUILDDIR)/html/index.html`"
 
 dirhtml:
 	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml

docs/django.rst

@@ -3,17 +3,4 @@ Django Support
 ==============
 
 .. note:: Django support has been split from the main MongoEngine
-    repository. The *legacy* Django extension may be found bundled with the
-    0.9 release of MongoEngine.
-
-
-
-Help Wanted!
-------------
-
-The MongoEngine team is looking for help contributing and maintaining a new
-Django extension for MongoEngine! If you have Django experience and would like
-to help contribute to the project, please get in touch on the
-`mailing list <http://groups.google.com/group/mongoengine-users>`_ or by
-simply contributing on
-`GitHub <https://github.com/MongoEngine/django-mongoengine>`_.
+    repository.

docs/guide/defining-documents.rst

@@ -29,7 +29,7 @@ documents are serialized based on their field order.
 
 .. _dynamic-document-schemas:
 
-Dynamic document schemas
+Dynamic Document Schemas
 ========================
 One of the benefits of MongoDB is dynamic schemas for a collection, whilst data
 should be planned and organised (after all explicit is better than implicit!)
@@ -260,7 +260,7 @@ document class as the first argument::
     comment2 = Comment(content='Nice article!')
     page = Page(comments=[comment1, comment2])
 
-Embedded documents can also leverage the flexibility of :ref:`dynamic-document-schemas:`
+Embedded documents can also leverage the flexibility of :ref:`dynamic-document-schemas`
 by inheriting :class:`~mongoengine.DynamicEmbeddedDocument`.
 
 Dictionary Fields
@@ -325,7 +325,7 @@ as the constructor's argument::
 .. _many-to-many-with-listfields:
 
 Many to Many with ListFields
-'''''''''''''''''''''''''''
+''''''''''''''''''''''''''''
 
 If you are implementing a many to many relationship via a list of references,
 then the references are stored as DBRefs and to query you need to pass an
@@ -492,7 +492,7 @@ The following example shows a :class:`Log` document that will be limited to
         meta = {'max_documents': 1000, 'max_size': 2000000}
 
 Timeseries collections
-------------------
+----------------------
 A :class:`~mongoengine.Document` may use a **Timeseries Collection** by specifying
 :attr:`timeseries` in the :attr:`meta` dictionary. Timeseries collection were added
 in MongoDB 5.0 (`doc <https://www.mongodb.com/docs/v5.3/core/timeseries-collections/>`_).

docs/guide/migration.rst

@@ -262,7 +262,7 @@ If you would remove the 'name' field or its index, you would have to call:
     User._get_collection().drop_index('name_1')
 
 .. note:: When adding new fields or new indexes, MongoEngine will take care of creating them
-    (unless `auto_create_index` is disabled) ::
+    (unless `auto_create_index` is disabled)
 
 Recommendations
 ===============

docs/index.rst

@@ -20,9 +20,6 @@ MongoDB. To install it, simply run
 :doc:`apireference`
   The complete API documentation --- the innards of documents, querysets and fields.
 
-:doc:`upgrade`
-  How to upgrade MongoEngine.
-
 :doc:`faq`
   Frequently Asked Questions
 
@@ -58,11 +55,7 @@ pull request.
 Changes
 -------
 
-See the :doc:`changelog` for a full list of changes to MongoEngine and
-:doc:`upgrade` for upgrade information.
-
-.. note::  Always read and test the `upgrade <upgrade>`_ documentation before
-    putting updates live in production **;)**
+See the :doc:`changelog` for a full list of changes to MongoEngine.
 
 Offline Reading
 ---------------
@@ -81,7 +74,6 @@ formats for offline reading.
     guide/index
     apireference
     changelog
-    upgrade
     faq
     django
 

docs/requirements.txt

@@ -1,5 +1,5 @@
-Sphinx==3.3.0
-sphinx-rtd-theme==0.5.0
-readthedocs-sphinx-ext==2.1.1
-docutils==0.17.1
-Jinja2<3.1
+Sphinx==7.4.7
+sphinx-rtd-theme==2.1.0rc2
+readthedocs-sphinx-ext==2.2.5
+docutils==0.20.1
+Jinja2==3.1.4

mongoengine/base/document.py

@@ -461,13 +461,13 @@ def to_json(self, *args, **kwargs):
 
     @classmethod
     def from_json(cls, json_data, created=False, **kwargs):
-        """Converts json data to a Document instance
+        """Converts json data to a Document instance.
 
-        :param str json_data: The json data to load into the Document
+        :param str json_data: The json data to load into the Document.
         :param bool created: Boolean defining whether to consider the newly
             instantiated document as brand new or as persisted already:
             * If True, consider the document as brand new, no matter what data
-              it's loaded with (i.e. even if an ID is loaded).
+              it's loaded with (i.e., even if an ID is loaded).
             * If False and an ID is NOT provided, consider the document as
               brand new.
             * If False and an ID is provided, assume that the object has