From eb0ce6fa3669971f1e21a3fdba270cf33d603eaa Mon Sep 17 00:00:00 2001 From: Tim Graham <timograham@gmail.com> Date: Thu, 27 Dec 2018 19:03:30 -0500 Subject: [PATCH] Added stub release notes for 3.0. --- docs/faq/install.txt | 1 + docs/releases/3.0.txt | 244 ++++++++++++++++++++++++++++++++++++++++ docs/releases/index.txt | 7 ++ 3 files changed, 252 insertions(+) create mode 100644 docs/releases/3.0.txt diff --git a/docs/faq/install.txt b/docs/faq/install.txt index 1aaaa56b29..231c06d042 100644 --- a/docs/faq/install.txt +++ b/docs/faq/install.txt @@ -49,6 +49,7 @@ Django version Python versions 1.11 2.7, 3.4, 3.5, 3.6, 3.7 (added in 1.11.17) 2.0 3.4, 3.5, 3.6, 3.7 2.1, 2.2 3.5, 3.6, 3.7 +3.0 3.6, 3.7, 3.8 ============== =============== For each version of Python, only the latest micro release (A.B.C) is officially diff --git a/docs/releases/3.0.txt b/docs/releases/3.0.txt new file mode 100644 index 0000000000..3b58097bf0 --- /dev/null +++ b/docs/releases/3.0.txt @@ -0,0 +1,244 @@ +============================================ +Django 3.0 release notes - UNDER DEVELOPMENT +============================================ + +*Expected December 2019* + +Welcome to Django 3.0! + +These release notes cover the :ref:`new features <whats-new-3.0>`, as well as +some :ref:`backwards incompatible changes <backwards-incompatible-3.0>` you'll +want to be aware of when upgrading from Django 2.2 or earlier. We've +:ref:`dropped some features<removed-features-3.0>` that have reached the end of +their deprecation cycle, and we've :ref:`begun the deprecation process for +some features <deprecated-features-3.0>`. + +See the :doc:`/howto/upgrade-version` guide if you're updating an existing +project. + +Python compatibility +==================== + +Django 3.0 supports Python 3.6, 3.7, and 3.8. We **highly recommend** and only +officially support the latest release of each series. + +The Django 2.2.x series is the last to support Python 3.5. + +Third-party library support for older version of Django +======================================================= + +Following the release of Django 3.0, we suggest that third-party app authors +drop support for all versions of Django prior to 2.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 3.0. + +.. _whats-new-3.0: + +What's new in Django 3.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 +~~~~ + +* ... + +Email +~~~~~ + +* ... + +File Storage +~~~~~~~~~~~~ + +* ... + +File Uploads +~~~~~~~~~~~~ + +* ... + + +Forms +~~~~~ + +* ... + +Generic Views +~~~~~~~~~~~~~ + +* ... + +Internationalization +~~~~~~~~~~~~~~~~~~~~ + +* ... + +Management Commands +~~~~~~~~~~~~~~~~~~~ + +* ... + +Migrations +~~~~~~~~~~ + +* ... + +Models +~~~~~~ + +* ... + +Requests and Responses +~~~~~~~~~~~~~~~~~~~~~~ + +* ... + +Serialization +~~~~~~~~~~~~~ + +* ... + +Signals +~~~~~~~ + +* ... + +Templates +~~~~~~~~~ + +* ... + +Tests +~~~~~ + +* ... + +URLs +~~~~ + +* ... + +Validators +~~~~~~~~~~ + +* ... + +.. _backwards-incompatible-3.0: + +Backwards incompatible changes in 3.0 +===================================== + +Database backend API +-------------------- + +This section describes changes that may be needed in third-party database +backends. + +* ... + +Miscellaneous +------------- + +* ... + +.. _deprecated-features-3.0: + +Features deprecated in 3.0 +========================== + +Miscellaneous +------------- + +* ... + +.. _removed-features-3.0: + +Features removed in 3.0 +======================= + +These features have reached the end of their deprecation cycle and are removed +in Django 3.0. + +See :ref:`deprecated-features-2.0` for details on these changes, including how +to remove usage of these features. + +* ... + +See :ref:`deprecated-features-2.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 c62ec0ae6b..ef5bb4ce36 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: +3.0 release +----------- +.. toctree:: + :maxdepth: 1 + + 3.0 + 2.2 release ----------- .. toctree::