From ea92a4dc2879e084b46d9b141c0a535d536be2e6 Mon Sep 17 00:00:00 2001 From: Mariusz Felisiak Date: Fri, 6 Jan 2023 07:31:13 +0100 Subject: [PATCH] Added stub release notes for 5.0. --- docs/faq/install.txt | 1 + docs/releases/5.0.txt | 263 ++++++++++++++++++++++++++++++++++++++++ docs/releases/index.txt | 7 ++ 3 files changed, 271 insertions(+) create mode 100644 docs/releases/5.0.txt diff --git a/docs/faq/install.txt b/docs/faq/install.txt index a0731fc717..402f7d7497 100644 --- a/docs/faq/install.txt +++ b/docs/faq/install.txt @@ -54,6 +54,7 @@ Django version Python versions 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 +5.0 3.10, 3.11, 3.12 ============== =============== For each version of Python, only the latest micro release (A.B.C) is officially diff --git a/docs/releases/5.0.txt b/docs/releases/5.0.txt new file mode 100644 index 0000000000..4b0277d962 --- /dev/null +++ b/docs/releases/5.0.txt @@ -0,0 +1,263 @@ +============================================ +Django 5.0 release notes - UNDER DEVELOPMENT +============================================ + +*Expected December 2023* + +Welcome to Django 5.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 4.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 5.0 supports Python 3.10, 3.11, and 3.12. 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 5.0, we suggest that third-party app authors +drop support for all versions of Django prior to 4.2. At that time, you should +be able to run your package's tests using ``python -Wd`` so that deprecation +warnings appear. After making the deprecation warning fixes, your app should be +compatible with Django 5.0. + +.. _whats-new-5.0: + +What's new in Django 5.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-5.0: + +Backwards incompatible changes in 5.0 +===================================== + +Database backend API +-------------------- + +This section describes changes that may be needed in third-party database +backends. + +* ... + +Miscellaneous +------------- + +* ... + +.. _deprecated-features-5.0: + +Features deprecated in 5.0 +========================== + +Miscellaneous +------------- + +* ... + +Features removed in 5.0 +======================= + +These features have reached the end of their deprecation cycle and are removed +in Django 5.0. + +See :ref:`deprecated-features-4.0` for details on these changes, including how +to remove usage of these features. + +* ... + +See :ref:`deprecated-features-4.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 3985e7e878..4ff0844453 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.0 release +----------- +.. toctree:: + :maxdepth: 1 + + 5.0 + 4.2 release -----------