|
@@ -0,0 +1,225 @@
|
|
|
+============================================
|
|
|
+Django 2.2 release notes - UNDER DEVELOPMENT
|
|
|
+============================================
|
|
|
+
|
|
|
+*Expected April 2019*
|
|
|
+
|
|
|
+Welcome to Django 2.2!
|
|
|
+
|
|
|
+These release notes cover the :ref:`new features <whats-new-2.2>`, as well as
|
|
|
+some :ref:`backwards incompatible changes <backwards-incompatible-2.2>` you'll
|
|
|
+want to be aware of when upgrading from Django 2.1 or earlier. We've
|
|
|
+:ref:`begun the deprecation process for some features
|
|
|
+<deprecated-features-2.2>`.
|
|
|
+
|
|
|
+See the :doc:`/howto/upgrade-version` guide if you're updating an existing
|
|
|
+project.
|
|
|
+
|
|
|
+Django 2.2 is designated as a :term:`long-term support release`. It will
|
|
|
+receive security updates for at least three years after its release. Support
|
|
|
+for the previous LTS, Django 1.11, will end in April 2020.
|
|
|
+
|
|
|
+Python compatibility
|
|
|
+====================
|
|
|
+
|
|
|
+Django 2.2 supports Python 3.5, 3.6, and 3.7. We **highly recommend** and only
|
|
|
+officially support the latest release of each series.
|
|
|
+
|
|
|
+.. _whats-new-2.2:
|
|
|
+
|
|
|
+What's new in Django 2.2
|
|
|
+========================
|
|
|
+
|
|
|
+Minor features
|
|
|
+--------------
|
|
|
+
|
|
|
+:mod:`django.contrib.admin`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.admindocs`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.auth`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.contenttypes`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.gis`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.messages`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.postgres`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.redirects`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.sessions`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.sitemaps`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.sites`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.staticfiles`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.syndication`
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Cache
|
|
|
+~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+CSRF
|
|
|
+~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Database backends
|
|
|
+~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Email
|
|
|
+~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+File Storage
|
|
|
+~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+File Uploads
|
|
|
+~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+
|
|
|
+Forms
|
|
|
+~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Generic Views
|
|
|
+~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Internationalization
|
|
|
+~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Management Commands
|
|
|
+~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Migrations
|
|
|
+~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Models
|
|
|
+~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Requests and Responses
|
|
|
+~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Serialization
|
|
|
+~~~~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Signals
|
|
|
+~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Templates
|
|
|
+~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Tests
|
|
|
+~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+URLs
|
|
|
+~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Validators
|
|
|
+~~~~~~~~~~
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+.. _backwards-incompatible-2.2:
|
|
|
+
|
|
|
+Backwards incompatible changes in 2.2
|
|
|
+=====================================
|
|
|
+
|
|
|
+Database backend API
|
|
|
+--------------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+:mod:`django.contrib.gis`
|
|
|
+-------------------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Miscellaneous
|
|
|
+-------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+.. _deprecated-features-2.2:
|
|
|
+
|
|
|
+Features deprecated in 2.2
|
|
|
+==========================
|
|
|
+
|
|
|
+Miscellaneous
|
|
|
+-------------
|
|
|
+
|
|
|
+* ...
|