diff --git a/docs/faq/install.txt b/docs/faq/install.txt index a89da571a9..ddb84d6d9c 100644 --- a/docs/faq/install.txt +++ b/docs/faq/install.txt @@ -50,12 +50,10 @@ What Python version can I use with Django? ============== =============== Django version Python versions ============== =============== -3.2 3.6, 3.7, 3.8, 3.9, 3.10 (added in 3.2.9) -4.0 3.8, 3.9, 3.10 -4.1 3.8, 3.9, 3.10, 3.11 (added in 4.1.3) 4.2 3.8, 3.9, 3.10, 3.11, 3.12 (added in 4.2.8) 5.0 3.10, 3.11, 3.12 5.1 3.10, 3.11, 3.12 +5.2 3.10, 3.11, 3.12, 3.13 ============== =============== For each version of Python, only the latest micro release (A.B.C) is officially diff --git a/docs/releases/5.2.txt b/docs/releases/5.2.txt new file mode 100644 index 0000000000..5c285e8f39 --- /dev/null +++ b/docs/releases/5.2.txt @@ -0,0 +1,253 @@ +============================================ +Django 5.2 release notes - UNDER DEVELOPMENT +============================================ + +*Expected April 2025* + +Welcome to Django 5.2! + +These release notes cover the :ref:`new features `, as well as +some :ref:`backwards incompatible changes ` you +should be aware of when upgrading from Django 5.1 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. + +Django 5.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 4.2, will +end in April 2026. + +Python compatibility +==================== + +Django 5.2 supports Python 3.10, 3.11, 3.12, and 3.13. We **highly recommend** +and only officially support the latest release of each series. + +.. _whats-new-5.2: + +What's new in Django 5.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` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* ... + +Asynchronous views +~~~~~~~~~~~~~~~~~~ + +* ... + +Cache +~~~~~ + +* ... + +CSRF +~~~~ + +* ... + +Database backends +~~~~~~~~~~~~~~~~~ + +* ... + +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-5.2: + +Backwards incompatible changes in 5.2 +===================================== + +Database backend API +-------------------- + +This section describes changes that may be needed in third-party database +backends. + +* ... + +Miscellaneous +------------- + +* ... + +.. _deprecated-features-5.2: + +Features deprecated in 5.2 +========================== + +Miscellaneous +------------- + +* ... diff --git a/docs/releases/index.txt b/docs/releases/index.txt index 982bb96ee3..820456fa7a 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: +5.2 release +----------- +.. toctree:: + :maxdepth: 1 + + 5.2 + 5.1 release ----------- .. toctree::