|
@@ -0,0 +1,235 @@
|
|
|
+============================================
|
|
|
+Django 2.0 release notes - UNDER DEVELOPMENT
|
|
|
+============================================
|
|
|
+
|
|
|
+Welcome to Django 2.0!
|
|
|
+
|
|
|
+These release notes cover the :ref:`new features <whats-new-2.0>`, as well as
|
|
|
+some :ref:`backwards incompatible changes <backwards-incompatible-2.0>` you'll
|
|
|
+want to be aware of when upgrading from Django 1.11 or earlier. We've
|
|
|
+:ref:`dropped some features<removed-features-2.0>` that have reached the end of
|
|
|
+their deprecation cycle, and we've :ref:`begun the deprecation process for some
|
|
|
+features <deprecated-features-2.0>`.
|
|
|
+
|
|
|
+See the :doc:`/howto/upgrade-version` guide if you're updating an existing
|
|
|
+project.
|
|
|
+
|
|
|
+Python compatibility
|
|
|
+====================
|
|
|
+
|
|
|
+Django 2.0 supports Python 3.5+. Since Django 1.11, support for Python 2.7 and
|
|
|
+3.4 is removed. We **highly recommend** and only officially support the latest
|
|
|
+release of each series.
|
|
|
+
|
|
|
+Third-party library support for older version of Django
|
|
|
+=======================================================
|
|
|
+
|
|
|
+Following the release of Django 2.0, we suggest that third-party app authors
|
|
|
+drop support for all versions of Django prior to 1.11. At that time, you should
|
|
|
+be able run your package's tests using ``python -Wd`` so that deprecation
|
|
|
+warnings do appear. After making the deprecation warning fixes, your app should
|
|
|
+be compatible with Django 2.0.
|
|
|
+
|
|
|
+.. _whats-new-2.0:
|
|
|
+
|
|
|
+What's new in Django 2.0
|
|
|
+========================
|
|
|
+
|
|
|
+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.0:
|
|
|
+
|
|
|
+Backwards incompatible changes in 2.0
|
|
|
+=====================================
|
|
|
+
|
|
|
+Database backend API
|
|
|
+--------------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+Miscellaneous
|
|
|
+-------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+.. _deprecated-features-2.0:
|
|
|
+
|
|
|
+Features deprecated in 2.0
|
|
|
+==========================
|
|
|
+
|
|
|
+Miscellaneous
|
|
|
+-------------
|
|
|
+
|
|
|
+* ...
|
|
|
+
|
|
|
+.. _removed-features-2.0:
|
|
|
+
|
|
|
+Features removed in 2.0
|
|
|
+=======================
|
|
|
+
|
|
|
+These features have reached the end of their deprecation cycle and are removed
|
|
|
+in Django 2.0. See :ref:`deprecated-features-1.9` and
|
|
|
+:ref:`deprecated-features-1.10` for details, including how to remove usage of
|
|
|
+these features.
|