Fixed #16671 - Added a tutorial on reuseable apps

Thank-you Katie Miller and Ben Sturmfels for the initial draft,
as well as Russ and Carl for the reviews.

AUTHORS

@@ -380,6 +380,7 @@ answer newbie questions, and generally made Django that much better:
     Christian Metts
     michal@plovarna.cz
     Slawek Mikula <slawek dot mikula at gmail dot com>
+    Katie Miller <katie@sub50.com>
     Shawn Milochik <shawn@milochik.com>
     mitakummaa@gmail.com
     Taylor Mitchell <taylor.mitchell@gmail.com>
@@ -510,6 +511,7 @@ answer newbie questions, and generally made Django that much better:
     Johan C. Stöver <johan@nilling.nl>
     Nowell Strite <http://nowell.strite.org/>
     Thomas Stromberg <tstromberg@google.com>
+    Ben Sturmfels <ben@sturm.com.au>
     Travis Swicegood <travis@domain51.com>
     Pascal Varet
     SuperJared

docs/index.txt

@@ -46,6 +46,9 @@ Are you new to Django or to programming? This is the place to start!
   :doc:`Part 3 <intro/tutorial03>` |
   :doc:`Part 4 <intro/tutorial04>`
 
+* **Advanced Tutorials:**
+  :doc:`How to write reusable apps <intro/reusable-apps>`
+
 The model layer
 ===============
 

docs/intro/index.txt

@@ -6,31 +6,32 @@ place: read this material to quickly get up and running.
 
 .. toctree::
    :maxdepth: 1
-    
+
    overview
    install
    tutorial01
    tutorial02
    tutorial03
    tutorial04
+   reusable-apps
    whatsnext
-   
+
 .. seealso::
 
     If you're new to Python_, you might want to start by getting an idea of what
     the language is like. Django is 100% Python, so if you've got minimal
     comfort with Python you'll probably get a lot more out of Django.
-    
+
     If you're new to programming entirely, you might want to start with this
     `list of Python resources for non-programmers`_
-    
+
     If you already know a few other languages and want to get up to speed with
     Python quickly, we recommend `Dive Into Python`_ (also available in a
     `dead-tree version`_). If that's not quite your style, there are quite
     a few other `books about Python`_.
-    
+
     .. _python: http://python.org/
     .. _list of Python resources for non-programmers: http://wiki.python.org/moin/BeginnersGuide/NonProgrammers
     .. _dive into python: http://diveintopython.net/
     .. _dead-tree version: http://www.amazon.com/exec/obidos/ASIN/1590593561/ref=nosim/jacobian20
-    .. _books about Python: http://wiki.python.org/moin/PythonBooks
\ No newline at end of file
+    .. _books about Python: http://wiki.python.org/moin/PythonBooks

docs/intro/tutorial03.txt

@@ -315,6 +315,12 @@ Load the page in your Web browser, and you should see a bulleted-list
 containing the "What's up" poll from Tutorial 1. The link points to the poll's
 detail page.
 
+.. admonition:: Organizing Templates
+
+    Rather than one big templates directory, you can also store templates
+    within each app. We'll discuss this in more detail in the :doc:`reusable
+    apps tutorial</intro/reusable-apps>`.
+
 A shortcut: :func:`~django.shortcuts.render`
 --------------------------------------------
 

docs/intro/tutorial04.txt

@@ -278,5 +278,10 @@ For full details on generic views, see the :doc:`generic views documentation
 What's next?
 ============
 
-The tutorial ends here for the time being. In the meantime, you might want to
-check out some pointers on :doc:`where to go from here </intro/whatsnext>`.
+The beginner tutorial ends here for the time being. In the meantime, you might
+want to check out some pointers on :doc:`where to go from here
+</intro/whatsnext>`.
+
+If you are familiar with Python packaging and interested in learning how to
+turn polls into a "reusable app", check out :doc:`Advanced tutorial: How to
+write reusable apps</intro/reusable-apps>`.