id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
30263	Mention the Media.merge change in the release notes	Matthias Kestenholz	Carlton Gibson	"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"", ...]` "	Cleanup/optimization	closed	Forms	2.2	Release blocker	fixed		Johannes Maron	Ready for checkin	1	0	0	0	0	0