Ticket #20493: 20493.diff

docs/howto/upgrade-version.txt

@@ -89 +89 @@
 When you are sufficiently confident your app works with the new version of
 Django, you're ready to go ahead and :doc:`deploy </howto/deployment/index>`
 your upgraded Django project.
+
+If you are using caching provided by Django, you'll want to consider whether or
+not you'll need to clear your cache after upgrading. You may run into problems,
+for example, if you are caching pickled objects
+(:class:`~django.http.HttpResponse`, for example) in Django as these objects
+are not guaranteed to be pickle-compatible across Django versions.