|
@@ -0,0 +1,225 @@
|
|
|
+============================================
|
|
|
+Django 2.1 release notes - UNDER DEVELOPMENT
|
|
|
+============================================
|
|
|
+
|
|
|
+Welcome to Django 2.1!
|
|
|
+
|
|
|
+These release notes cover the :ref:`new features <whats-new-2.1>`, as well as
|
|
|
+some :ref:`backwards incompatible changes <backwards-incompatible-2.1>` you'll
|
|
|
+want to be aware of when upgrading from Django 2.0 or earlier. We've
|
|
|
+:ref:`dropped some features<removed-features-2.1>` that have reached the end of
|
|
|
+their deprecation cycle, and we've :ref:`begun the deprecation process for some
|
|
|
+features <deprecated-features-2.1>`.
|
|
|
+
|
|
|
+See the :doc:`/howto/upgrade-version` guide if you're updating an existing
|
|
|
+project.
|
|
|
+
|
|
|
+Python compatibility
|
|
|
+====================
|
|
|
+
|
|
|
+Django 2.1 supports Python 3.5, 3.6, and 3.7. Django 2.0 is the last version to
|
|
|
+support Python 3.4. We **highly recommend** and only officially support the
|
|
|
+latest release of each series.
|
|
|
+
|
|
|
+.. _whats-new-2.1:
|
|
|
+
|
|
|
+What's new in Django 2.1
|
|
|
+========================
|
|
|
+
|
|
|
+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.1:
|
|
|
+
|
|
|
+Backwards incompatible changes in 2.1
|
|
|
+=====================================
|
|
|
+
|
|
|
+Database backend API
|
|
|
+--------------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Miscellaneous
|
|
|
+-------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+.. _deprecated-features-2.1:
|
|
|
+
|
|
|
+Features deprecated in 2.1
|
|
|
+==========================
|
|
|
+
|
|
|
+Miscellaneous
|
|
|
+-------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+.. _removed-features-2.1:
|
|
|
+
|
|
|
+Features removed in 2.1
|
|
|
+=======================
|
|
|
+
|
|
|
+These features have reached the end of their deprecation cycle and are removed
|
|
|
+in Django 2.1. See :ref:`deprecated-features-1.11` for details, including how
|
|
|
+to remove usage of these features.
|