Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Some 2.0 release note tweaks #9310

Merged
merged 1 commit into from Nov 1, 2017
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
32 changes: 18 additions & 14 deletions docs/releases/2.0.txt
Expand Up @@ -12,9 +12,9 @@ their deprecation cycle, and we've :ref:`begun the deprecation process for some
features <deprecated-features-2.0>`.

This release starts Django's use of a :ref:`loose form of semantic versioning
<internal-release-cadence>`, however, there aren't any major backwards
incompatible changes that might be expected of a 2.0 release. Upgrading should
be a similar amount of effort as past feature releases.
<internal-release-cadence>`, but there aren't any major backwards incompatible
changes that might be expected of a 2.0 release. Upgrading should be a similar
amount of effort as past feature releases.

See the :doc:`/howto/upgrade-version` guide if you're updating an existing
project.
Expand Down Expand Up @@ -60,10 +60,13 @@ could be written as::

The new syntax supports type coercion of URL parameters. In the example, the
view will receive the ``year`` keyword argument as an integer rather than as
a string.
a string. Also, the URLs that will match are slightly less constrained in the
rewritten example. For example, the year 10000 will now match since the year
integers aren't constrained to be exactly four digits long as they are in the
regular expression.

The ``django.conf.urls.url()`` function from previous versions is now available
as :func:`django.urls.re_path`, however, the old location remains for backwards
as :func:`django.urls.re_path`. The old location remains for backwards
compatibility, without an imminent deprecation. The old
``django.conf.urls.include()`` function is now importable from ``django.urls``
so you can use ``from django.urls import include, path, re_path`` in your
Expand All @@ -75,8 +78,8 @@ and provide more details.
Mobile-friendly ``contrib.admin``
---------------------------------

The admin is now responsive and supports all major mobile devices.
Older browsers may experience varying levels of graceful degradation.
The admin is now responsive and supports all major mobile devices. Older
browsers may experience varying levels of graceful degradation.

Window expressions
------------------
Expand Down Expand Up @@ -172,8 +175,8 @@ Minor features
Cache
~~~~~

* On memcached, ``cache.set_many()`` returns a list of keys that failed to be
inserted.
* ``cache.set_many()`` now returns a list of keys that failed to be inserted.
For the built-in backends, failed inserts can only happen on memcached.

File Storage
~~~~~~~~~~~~
Expand Down Expand Up @@ -222,8 +225,8 @@ Management Commands
Migrations
~~~~~~~~~~

* The new :option:`squashmigrations --squashed-name` option allows naming
the squashed migration.
* The new :option:`squashmigrations --squashed-name` option allows naming the
squashed migration.

Models
~~~~~~
Expand All @@ -242,7 +245,7 @@ Models
controls the number of results Django fetches from the database adapter.

* :meth:`.QuerySet.earliest`, :meth:`.QuerySet.latest`, and
:attr:`Meta.get_latest_by <django.db.models.Options.get_latest_by>` now
:attr:`Meta.get_latest_by <django.db.models.Options.get_latest_by>` now
allow ordering by several fields.

* Added the :class:`~django.db.models.functions.ExtractQuarter` function to
Expand Down Expand Up @@ -776,7 +779,8 @@ See :ref:`deprecated-features-1.10` for details on these changes.

* The ``shell --plain`` option is removed.

* The ``django.core.urlresolvers`` module is removed.
* The ``django.core.urlresolvers`` module is removed in favor of its new
Copy link
Sponsor Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This one is kind of mentioned above in the "see deprecated features in 1.10" link, but it took me some time to notice when upgrading and I thought inlining it here would be helpful since I think it will be very common.

location, ``django.urls``.

* ``CommaSeparatedIntegerField`` is removed, except for support in historical
migrations.
Expand All @@ -797,7 +801,7 @@ See :ref:`deprecated-features-1.10` for details on these changes.
* Using ``User.is_authenticated()`` and ``User.is_anonymous()`` as methods
rather than properties is no longer supported.

* The ``Model._meta.virtual_fields`` attribute is removed.
* The ``Model._meta.virtual_fields`` attribute is removed.

* The keyword arguments ``virtual_only`` in ``Field.contribute_to_class()`` and
``virtual`` in ``Model._meta.add_field()`` are removed.
Expand Down