#30263: Mention the Media.merge change in the release notes
------------------------------------------------+------------------------
Reporter: Matthias Kestenholz | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Forms | Version: 2.2
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
------------------------------------------------+------------------------
The Media merge change (#30179, #30153) has some potential of breaking
libraries which worked before. It would be nice to give a heads-up to
developers that they have to check their `Media` definitions.
The necessary change to django-content-editor was really small:
https://github.com/matthiask/django-content-
editor/commit/ed662db302fd74033ce62031bb11b6f8beddf249
Here's a draft for the release notes (I hope it helps -- I'm finding it
hard to keep it short while still providing an useful example)
--
Merging of media classes
The `Media` class merging algorithm has been changed to produce sensible
results when pairwise merging is insufficient. However, CSS and JavaScript
files which do not properly declare their dependencies may now be
reordered **before** their dependencies. This only ever worked by
accident.
The recommendation is to check all `Media` declarations for dependencies
and make those explicit. Just as an example, widgets depending on
`django.jQuery` should specify `js=["admin/js/jquery.init.js", ...]`
--
Ticket URL: <https://code.djangoproject.com/ticket/30263>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/052.9568f1e8056326f8dd4cdc0e309eab77%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
