diff --git a/docs/patterns.rst b/docs/patterns.rst
index 5047ea73..3809f754 100644
--- a/docs/patterns.rst
+++ b/docs/patterns.rst
@@ -164,3 +164,85 @@ this template "extends" another template. When the template system evaluates
this template, first it locates the parent. The extends tag must be the
first tag in the template. To render the contents of a block defined in
the parent template, use ``{{ super() }}``.
+
+.. _message-flashing-pattern:
+
+Message Flashing
+----------------
+
+Good applications and user interfaces are all about feedback. If the user
+does not get enough feedback he will probably end up hating the
+application. Flask provides a really simple way to give feedback to a
+user with the flashing system. The flashing system basically makes it
+possible to record a message at the end of a request and access it next
+request and only next request. This is usually combined with a layout
+template that does this.
+
+So here a full example::
+
+ from flask import flash, redirect, url_for, render_template
+
+ @app.route('/')
+ def index():
+ return render_template('index.html')
+
+ @app.route('/login', methods=['GET', 'POST'])
+ def login():
+ error = None
+ if request.method == 'POST':
+ if request.form['username'] != 'admin' or \
+ request.form['password'] != 'secret':
+ error = 'Invalid credentials'
+ else:
+ flash('You were sucessfully logged in')
+ return redirect(url_for('index'))
+ return render_template('login.html', error=error)
+
+And here the ``layout.html`` template which does the magic:
+
+.. sourcecode:: html+jinja
+
+
+ My Application
+ {% with messages = get_flashed_messages() %}
+ {% if messages %}
+
+ {% for message in messages %}
+ - {{ message }}
+ {% endfor %}
+
+ {% endif %}
+ {% endwith %}
+ {% block body %}{% endblock %}
+
+And here the index.html template:
+
+.. sourcecode:: html+jinja
+
+ {% extends "layout.html" %}
+ {% block body %}
+ Overview
+ Do you want to log in?
+ {% endblock %}
+
+And of course the login template:
+
+.. sourcecode:: html+jinja
+
+ {% extends "layout.html" %}
+ {% block body %}
+
Login
+ {% if error %}
+ Error: {{ error }}
+ {% endif %}
+
+ {% endblock %}
diff --git a/docs/quickstart.rst b/docs/quickstart.rst
index 64ef0368..54a421e9 100644
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -489,71 +489,7 @@ possible to record a message at the end of a request and access it next
request and only next request. This is usually combined with a layout
template that does this.
-So here a full example::
-
- from flask import flash, redirect, url_for, render_template
-
- @app.route('/')
- def index():
- return render_template('index.html')
-
- @app.route('/login', methods=['GET', 'POST'])
- def login():
- error = None
- if request.method == 'POST':
- if request.form['username'] != 'admin' or \
- request.form['password'] != 'secret':
- error = 'Invalid credentials'
- else:
- flash('You were sucessfully logged in')
- return redirect(url_for('index'))
- return render_template('login.html', error=error)
-
-And here the ``layout.html`` template which does the magic:
-
-.. sourcecode:: html+jinja
-
-
- My Application
- {% with messages = get_flashed_messages() %}
- {% if messages %}
-
- {% for message in messages %}
- - {{ message }}
- {% endfor %}
-
- {% endif %}
- {% endwith %}
- {% block body %}{% endblock %}
-
-And here the index.html template:
-
-.. sourcecode:: html+jinja
-
- {% extends "layout.html" %}
- {% block body %}
- Overview
- Do you want to log in?
- {% endblock %}
-
-And of course the login template:
-
-.. sourcecode:: html+jinja
-
- {% extends "layout.html" %}
- {% block body %}
-
Login
- {% if error %}
- Error: {{ error }}
- {% endif %}
-
- {% endblock %}
+To flash a message use the :func:`~flask.flash` method, to get hold of the
+messages you can use :func:`~flask.get_flashed_messages` which is also
+available in the templates. Check out the :ref:`message-flashing-pattern`
+for a full example.