Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Add code organization help to tutorial doc.

As suggested by burhan on #pocoo today.
  • Loading branch information...
commit c240a1f78101c57591bd23f26a367d214d533eac 1 parent 34c4709
@rduplain rduplain authored
Showing with 16 additions and 0 deletions.
  1. +16 −0 docs/tutorial/dbcon.rst
View
16 docs/tutorial/dbcon.rst
@@ -39,3 +39,19 @@ environments. That special :data:`~flask.g` object does some magic behind
the scenes to ensure it does the right thing.
Continue to :ref:`tutorial-views`.
+
+.. hint:: Where do I put this code?
+
+ If you've been following along in this tutorial, you might be wondering
+ where to put the code from this step and the next. A logical place is to
+ group these module-level functions together, and put your new
+ ``before_request`` and ``teardown_request`` functions below your existing
+ ``init_db`` function (following the tutorial line-by-line).
+
+ If you need a moment to find your bearings, take a look at how the `example
+ source`_ is organized. In Flask, you can put all of your application code
+ into a single Python module. You don't have to, and if your app :ref:`grows
+ larger <larger-applications>`, it's a good idea not to.
+
+.. _example source:
+ http://github.com/mitsuhiko/flask/tree/master/examples/flaskr/
Please sign in to comment.
Something went wrong with that request. Please try again.