mirror of
				https://github.com/django/django.git
				synced 2025-11-03 21:25:09 +00:00 
			
		
		
		
	Added stub release notes for 3.0.
This commit is contained in:
		
							parent
							
								
									ffe53096a9
								
							
						
					
					
						commit
						eb0ce6fa36
					
				
					 3 changed files with 252 additions and 0 deletions
				
			
		| 
						 | 
				
			
			@ -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
									
								
								docs/releases/3.0.txt
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										244
									
								
								docs/releases/3.0.txt
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -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.
 | 
			
		||||
 | 
			
		||||
* ...
 | 
			
		||||
| 
						 | 
				
			
			@ -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::
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue