Browse Source

Added stub release notes for 3.0.

Tim Graham 6 years ago
parent
commit
eb0ce6fa36
3 changed files with 252 additions and 0 deletions
  1. 1 0
      docs/faq/install.txt
  2. 244 0
      docs/releases/3.0.txt
  3. 7 0
      docs/releases/index.txt

+ 1 - 0
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

+ 244 - 0
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.
+
+* ...

+ 7 - 0
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::