Browse files

Big glaring warning in docs/flatpages.txt to remind people how respon…

…se middleware works

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
ubernostrum committed May 28, 2008
1 parent 4d79a95 commit bd73eaf952b65b17580498fee846e8fddace68db
Showing with 11 additions and 0 deletions.
  1. +11 −0 docs/flatpages.txt
@@ -66,6 +66,17 @@ resort.
For more on middleware, read the `middleware docs`_.
+.. admonition:: Ensure that your 404 template works
+ Note that the ``FlatpageFallbackMiddleware`` only steps in once
+ another view has successfully produced a 404 response. If another
+ view or middleware class attempts to produce a 404 but ends up
+ raising an exception instead (such as a ``TemplateDoesNotExist``
+ exception if your site does not have an appropriate template to
+ use for HTTP 404 responses), the response will become an HTTP 500
+ ("Internal Server Error") and the ``FlatpageFallbackMiddleware``
+ will not attempt to serve a flat page.
.. _SITE_ID: ../settings/#site-id
.. _RequestContext: ../templates_python/#subclassing-context-djangocontext
.. _middleware docs: ../middleware/

0 comments on commit bd73eaf

Please sign in to comment.