diff --git a/docs/faq/install.txt b/docs/faq/install.txt index 1618d40c8e..716c4fb557 100644 --- a/docs/faq/install.txt +++ b/docs/faq/install.txt @@ -54,6 +54,7 @@ Django version Python versions 3.0 3.6, 3.7, 3.8, 3.9 (added in 3.0.11) 3.1 3.6, 3.7, 3.8, 3.9 (added in 3.1.3) 3.2 3.6, 3.7, 3.8, 3.9 +4.0 3.8, 3.9, 3.10 ============== =============== For each version of Python, only the latest micro release (A.B.C) is officially diff --git a/docs/releases/4.0.txt b/docs/releases/4.0.txt new file mode 100644 index 0000000000..cc8c698ba4 --- /dev/null +++ b/docs/releases/4.0.txt @@ -0,0 +1,254 @@ +============================================ +Django 4.0 release notes - UNDER DEVELOPMENT +============================================ + +*Expected December 2021* + +Welcome to Django 4.0! + +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you'll +want to be aware of when upgrading from Django 3.2 or earlier. We've +:ref:`begun the deprecation process for some features +`. + +See the :doc:`/howto/upgrade-version` guide if you're updating an existing +project. + +Python compatibility +==================== + +Django 4.0 supports Python 3.8, 3.9, and 3.10. We **highly recommend** and only +officially support the latest release of each series. + +.. _whats-new-4.0: + +What's new in Django 4.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 +~~~~ + +* ... + +Decorators +~~~~~~~~~~ + +* ... + +Email +~~~~~ + +* ... + +Error Reporting +~~~~~~~~~~~~~~~ + +* ... + +File Storage +~~~~~~~~~~~~ + +* ... + +File Uploads +~~~~~~~~~~~~ + +* ... + +Forms +~~~~~ + +* ... + +Generic Views +~~~~~~~~~~~~~ + +* ... + +Internationalization +~~~~~~~~~~~~~~~~~~~~ + +* ... + +Logging +~~~~~~~ + +* ... + +Management Commands +~~~~~~~~~~~~~~~~~~~ + +* ... + +Migrations +~~~~~~~~~~ + +* ... + +Models +~~~~~~ + +* ... + +Requests and Responses +~~~~~~~~~~~~~~~~~~~~~~ + +* ... + +Security +~~~~~~~~ + +* ... + +Serialization +~~~~~~~~~~~~~ + +* ... + +Signals +~~~~~~~ + +* ... + +Templates +~~~~~~~~~ + +* ... + +Tests +~~~~~ + +* ... + +URLs +~~~~ + +* ... + +Utilities +~~~~~~~~~ + +* ... + +Validators +~~~~~~~~~~ + +* ... + +.. _backwards-incompatible-4.0: + +Backwards incompatible changes in 4.0 +===================================== + +Database backend API +-------------------- + +This section describes changes that may be needed in third-party database +backends. + +* ... + +Miscellaneous +------------- + +* ... + +.. _deprecated-features-4.0: + +Features deprecated in 4.0 +========================== + +Miscellaneous +------------- + +* ... + +Features removed in 4.0 +======================= + +These features have reached the end of their deprecation cycle and are removed +in Django 4.0. + +See :ref:`deprecated-features-3.0` for details on these changes, including how +to remove usage of these features. + +* ... + +See :ref:`deprecated-features-3.1` for details on these changes, including how +to remove usage of these features. + +* ... diff --git a/docs/releases/index.txt b/docs/releases/index.txt index 457d69e034..68733d9b24 100644 --- a/docs/releases/index.txt +++ b/docs/releases/index.txt @@ -20,6 +20,13 @@ versions of the documentation contain the release notes for any later releases. .. _development_release_notes: +4.0 release +----------- +.. toctree:: + :maxdepth: 1 + + 4.0 + 3.2 release ----------- .. toctree::