[1.7.x] Fixed #23437 -- Documented required update of WSGI scripts for 1.7.

Thanks Tim for the review.

Backport of dfe209a from master

1 files changed, 16 insertions, 0 deletions

diff --git a/docs/releases/1.7.txt b/docs/releases/1.7.txt
index 72951b5262..38f2376d39 100644
--- a/docs/releases/1.7.txt
+++ b/docs/releases/1.7.txt
@@ -1020,6 +1020,22 @@ script with::
 
 Otherwise, you will hit an ``AppRegistryNotReady`` exception.
 
+WSGI scripts
+~~~~~~~~~~~~
+
+Until Django 1.3, the recommended way to create a WSGI application was::
+
+    import django.core.handlers.wsgi
+    application = django.core.handlers.wsgi.WSGIHandler()
+
+In Django 1.4, support for WSGI was improved and the API changed to::
+
+    from django.core.wsgi import get_wsgi_application
+    application = get_wsgi_application()
+
+If you're still using the former style in your WSGI script, you need to
+upgrade to the latter, or you will hit an ``AppRegistryNotReady`` exception.
+
 App registry consistency
 ^^^^^^^^^^^^^^^^^^^^^^^^