21 files changed, 152 insertions, 253 deletions
diff --git a/docs/quick_tour.rst b/docs/quick_tour.rst
index c6cda54a6..434dbdad5 100644
--- a/docs/quick_tour.rst
+++ b/docs/quick_tour.rst
@@ -5,216 +5,42 @@ Quick Tour of Pyramid
 =====================
 
 Pyramid lets you start small and finish big.  This *Quick Tour* of Pyramid is
-for those who want to evaluate Pyramid and are not yet familiar with it.
+for those who want to evaluate Pyramid, whether you are new to Python
+web frameworks, or a pro in a hurry. For more detailed treatment of
+each topic, give the :ref:`quick_tutorial` a try.
 
-
-Conventions
-===========
-This guide uses conventions to keep the introduction focused and concise.
-Details, references, and deeper discussions are mentioned in "See Also"
-notes.
-
-.. seealso:: This is an example "See Also" note.
-
-Pyramid encourages standard Python development practices with packaging tools,
-virtual environments, logging, and so on.  There are many variations,
-implementations, and opinions across the Python community, each of which may
-have its proper usage.  For the sake of consistency, ease of documentation
-maintenance, and to minimize confusion, the Pyramid documentation has adopted
-specific conventions:
-
-* Pyramid fully supports Python 3.2 or greater as well as Python 2.6 and 2.7.
-  This guide uses Python 3.
-* We use ``pyvenv`` for isolating Python environments.
-* We use ``setuptools`` for package management.
-* We organize our file system where our home directory contains all of our
-  projects, which contains our workspaces, which contain both Python virtual
-  environments and projects.
-* Commands in this guide use UNIX syntax and paths.  Windows users should
-  adjust commands accordingly.
-
-.. note::
-
-    Pyramid was one of the first web frameworks to fully support Python 3 in
-    October 2011.
-
-Requirements
+Installation
 ============
 
-* :ref:`install-python-3.3-or-greater`
-* :ref:`create-a-project-directory-structure`
-* :ref:`set-an-environment-variable`
-* :ref:`create-a-virtual-environment`
-* :ref:`install-setuptools-(python-packaging-tools)`
-* :ref:`install-pyramid`
-
-.. warning:: The current state of isolated Python environments using
-    ``pyvenv`` on Windows is suboptimal in comparison to Mac and Linux.  See
-    http://stackoverflow.com/q/15981111/95735 for a discussion of the issue
-    and `PEP 453 <http://www.python.org/dev/peps/pep-0453/>`_ for a proposed
-    resolution. When it is resolved, or if any Windows user would like to step
-    forward, we would gratefully accept a pull request to update our
-    documentation.
-    
-    Until then, we recommend that Windows users follow the procedure
-    :ref:`Installing Pyramid on a Windows System <installing_windows>`
-
-.. _install-python-3.3-or-greater:
-
-Install Python 3.3 or greater
------------------------------
-
-Download the latest standard Python 3 release (not development release) from
-`python.org <http://www.python.org/download/releases/>`_.  On that page, you
-must click the latest version, then scroll down to the "Downloads" section
-for your operating system.
-
-Windows and Mac OS X users can download and run an installer.
-
-Windows users should also install the `Python for Windows extensions
-<http://sourceforge.net/projects/pywin32/files/pywin32/>`_. Carefully read the
-``README.txt`` file at the end of the list of builds, and follow its
-directions. Make sure you get the proper 32- or 64-bit build and Python
-version.
-
-Linux users can either use their package manager to install Python 3 or may
-`build Python 3 from source
-<http://pyramid.readthedocs.org/en/master/narr/install.html#package-manager-
-method>`_.
-
-
-.. _create-a-project-directory-structure:
-
-Create a project directory structure
-------------------------------------
-
-From your user home directory, create the following initial directory structure
-as indicated in the figure below.
-
-.. figure:: _static/directory_structure_initial.png
-   :alt: initial directory structure
-
-   An initial directory structure.
-
-The commands to do so are as follows:
-
-.. code-block:: bash
-    
-    # Mac and Linux
-    $ cd ~
-    $ mkdir projects
-    $ cd projects
-    $ mkdir pyramid
-    
-    # Windows
-    c:\> cd \
-    c:\> mkdir projects
-    c:\> cd projects
-    c:\> mkdir pyramid
-    
-In the above figure, your user home directory is represented by ``~``.  In
-your home directory, all of your projects are in the ``projects`` directory. 
-This is a general convention not specific to Pyramid that many developers use.
-Windows users will do well to use ``c:\`` as the location for ``projects`` in
-order to avoid spaces in any of the path names.
-
-Next within ``projects`` is your workspace directory, here named ``pyramid``. 
-A workspace is a common term used by integrated development environments (IDE)
-like PyCharm and PyDev that stores isolated Python environments (virtualenvs)
-and specific project files and repositories.
-
-
-.. _set-an-environment-variable:
-
-Set an Environment Variable
----------------------------
-
-We set an environment variable to save typing later.
-
-.. code-block:: bash
-    
-    # Mac and Linux
-    $ export VENV=~/projects/pyramid/env33/bin/
-    
-    # Windows
-    # TODO: This command does not work
-    c:\> set VENV=c:\projects\pyramid\env33
-
-
-.. _create-a-virtual-environment:
-
-Create a Virtual Environment
-----------------------------
-``pyvenv`` is a tool to create isolated Python environments.  Create one.
-
-.. code-block:: bash
-
-    # Mac and Linux
-    $ pyvenv $VENV
-    
-    # Windows
-    # TODO: This command does work, but we should improve it with %VENV%
-    c:\> .\Python33\python -m venv c:\projects\pyramid\env33
-
-.. note:: ``pyvenv`` is a tool to create isolated Python environments. The
-    venv module provides support for creating lightweight "virtual
-    environments" with their own site directories, optionally isolated from
-    system site directories. Each virtual environment has its own Python binary
-    (allowing creation of environments with various Python versions) and can
-    have its own independent set of installed Python packages in its site
-    directories.
-
-.. seealso:: See also Python 3's :mod:`venv module <python3:venv>` and Python
-    2's `virtualenv <http://www.virtualenv.org/en/latest/>`_ package.
-
-
-.. _install-setuptools-(python-packaging-tools):
-
-Install ``setuptools`` (Python packaging tools)
------------------------------------------------
+Once you have a standard Python environment setup, getting started with
+Pyramid is a breeze. Unfortunately "standard" is not so simple in Python.
+For this Quick Tour, it means:
+`Python <http://www.python.org/download/releases/>`_, a
+`virtual environment <http://docs.python.org/dev/library/venv.html>`_
+(or `virtualenv for Python 2.7 <https://pypi.python.org/pypi/virtualenv>`_,
+and `setuptools <https://pypi.python.org/pypi/setuptools/>`_.
 
-The following command will download a script to install ``setuptools``, then
-pipe it to your environment's version of Python.
+As an example, for Python 3.3+ on Linux:
 
 .. code-block:: bash
 
-    # Mac and Linux
-    $ wget https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py -O - | $VENV/python
-    
-    # Windows
-    # TODO Something goes here
+  $ pyvenv env33
+  $ wget https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py -O - | env33/bin/python
+  $ env33/bin/easy_install pyramid
 
-If ``wget`` complains with a certificate error, then run this command instead:
+For Windows:
 
-.. code-block:: bash
-
-    # Mac and Linux
-    $ wget --no-check-certificate https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py -O - | $VENV/python
-
-    # Windows
-    # TODO Something goes here
-
-
-.. _install-pyramid:
-
-Install Pyramid
----------------
-
-.. code-block:: bash
-    
-    # Mac and Linux
-    $ easy_install pyramid
-    
-    # Windows
-    # TODO Something goes here
-
-Our Python environment now has the Pyramid software available.  Your directory structure should now look like the following image.
+.. code-block:: posh
 
-.. figure:: _static/directory_structure_pyramid.png
-   :alt: Pyramid directory structure
-
-   A Pyramid directory structure.
+    # Use your browser to download:
+    #   https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py
+    c:\> c:\Python33\python -m venv env33
+    c:\> env33\Scripts\python ez_setup.py
+    c:\> env33\Scripts\easy_install pyramid
 
+Of course Pyramid runs fine on Python 2.6+, as do the examples in this
+*Quick Tour*. We're just showing Python 3 a little love (Pyramid had
+production support in October 2011.)
 
 .. note::
 
@@ -223,25 +49,11 @@ Our Python environment now has the Pyramid software available.  Your directory s
     some optional C extensions for performance. With ``easy_install``, Windows
     users can get these extensions without needing a C compiler.
 
-.. seealso:: See Also: :ref:`installing_unix`. For instructions to set up your
-    Python environment for development using Windows or Python 2, see Pyramid's
-    :ref:`Before You Install <installing_chapter>`.
-    
-    See also Python 3's :mod:`venv module <python3:venv>`, the `setuptools` `installation instructions
-    <https://pypi.python.org/pypi/setuptools/0.9.8#installation-instructions>`_,
-    and `easy_install help <https://pypi.python.org/pypi/setuptools/0.9.8#using-setuptools-and-easyinstall>`_.
-
-.. note::  A generic representation of project directory structure is shown in
-    the following figure.  We could create multiple isolated Python
-    environments for multiple versions of Python.  We could also add more
-    projects within our workspace directory, which is a common practice in the
-    Pyramid tutorials.
-
-.. figure:: _static/directory_structure_generic.png
-   :alt: generic directory structure
-
-   A generic directory structure.
-
+.. seealso:: See Also:
+    :ref:`Quick Tutorial section on Requirements <qtut_requirements>`,
+    :ref:`installing_unix`,
+    :ref:`Before You Install <installing_chapter>`, and
+    :ref:`Installing Pyramid on a Windows System <installing_windows>`
 
 Hello World
 ===========
@@ -280,7 +92,9 @@ in Pyramid development. Building an application from loosely-coupled
 parts via :doc:`../narr/configuration` is a central idea in Pyramid,
 one that we will revisit regurlarly in this *Quick Tour*.
 
-.. seealso:: See Also: :ref:`firstapp_chapter` and
+.. seealso:: See Also:
+   :ref:`Quick Tutorial Hello World <qtut_hello_world>`,
+   :ref:`firstapp_chapter`, and
    :ref:`Single File Tasks tutorial <tutorials:single-file-tutorial>`
 
 Handling Web Requests and Responses
@@ -311,7 +125,10 @@ the name is included in the body of the response::
 
 Finally, we set the response's content type and return the Response.
 
-.. seealso:: See Also: :ref:`webob_chapter`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Request and Response <qtut_request_response>`
+    and
+    :ref:`webob_chapter`
 
 Views
 =====
@@ -361,7 +178,9 @@ configuration`, in which a Python :term:`decorator` is placed on the
 line above the view. Both approaches result in the same final
 configuration, thus usually, it is simply a matter of taste.
 
-.. seealso:: See Also: :doc:`../narr/views`,
+.. seealso:: See Also:
+   :ref:`Quick Tutorial Views <qtut_views>`,
+   :doc:`../narr/views`,
    :doc:`../narr/viewconfig`, and
    :ref:`debugging_view_configuration`
 
@@ -407,7 +226,9 @@ view:
 "replacement patterns" (the curly braces) in the route declaration.
 This information can then be used in your view.
 
-.. seealso:: See Also: :doc:`../narr/urldispatch`,
+.. seealso:: See Also:
+   :ref:`Quick Tutorial Routing <qtut_routing>`,
+   :doc:`../narr/urldispatch`,
    :ref:`debug_routematch_section`, and
    :doc:`../narr/router`
 
@@ -441,9 +262,11 @@ Since our view returned ``dict(name=request.matchdict['name'])``,
 we can use ``name`` as a variable in our template via
 ``${name}``.
 
-.. seealso:: See Also: :doc:`../narr/templates`,
-   :ref:`debugging_templates`, and
-   :ref:`available_template_system_bindings`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Templating <qtut_templating>`,
+    :doc:`../narr/templates`,
+    :ref:`debugging_templates`, and
+    :ref:`available_template_system_bindings`
 
 Templating With ``jinja2``
 ==========================
@@ -482,9 +305,10 @@ filename extensions. In this case, changing the extension from ``.pt``
 to ``.jinja2`` passed the view response through the ``pyramid_jinja2``
 renderer.
 
-.. seealso:: See Also: `Jinja2 homepage <http://jinja.pocoo.org/>`_,
-   and
-   :ref:`pyramid_jinja2 Overview <jinja2:overview>`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Jinja2 <qtut_jinja2>`,
+    `Jinja2 homepage <http://jinja.pocoo.org/>`_, and
+    :ref:`pyramid_jinja2 Overview <jinja2:overview>`
 
 Static Assets
 =============
@@ -529,9 +353,11 @@ By using ``request.static_url`` to generate the full URL to the static
 assets, you both ensure you stay in sync with the configuration and
 gain refactoring flexibility later.
 
-.. seealso:: See Also: :doc:`../narr/assets`,
-   :ref:`preventing_http_caching`, and
-   :ref:`influencing_http_caching`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Static Assets <qtut_static_assets>`,
+    :doc:`../narr/assets`,
+    :ref:`preventing_http_caching`, and
+    :ref:`influencing_http_caching`
 
 Returning JSON
 ==============
@@ -548,9 +374,11 @@ This wires up a view that returns some data through the JSON
 :term:`renderer`, which calls Python's JSON support to serialize the data
 into JSON and set the appropriate HTTP headers.
 
-.. seealso:: See Also: :ref:`views_which_use_a_renderer`,
-   :ref:`json_renderer`, and
-   :ref:`adding_and_overriding_renderers`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial JSON <qtut_json>`,
+    :ref:`views_which_use_a_renderer`,
+    :ref:`json_renderer`, and
+    :ref:`adding_and_overriding_renderers`
 
 View Classes
 ============
@@ -593,7 +421,20 @@ Only one route needed, stated in one place atop the view class. Also,
 the assignment of the ``name`` is done in the ``__init__``. Our
 templates can then use ``{{ view.name }}``.
 
-.. seealso:: See Also: :ref:`class_as_view`
+Pyramid view classes, combined with built-in and custom predicates,
+have much more to offer:
+
+- All the same view configuration parameters as function views
+
+- One route leading to multiple views, based on information in the
+  request or data such as ``request_param``, ``request_method``,
+  ``accept``, ``header``, ``xhr``, ``containment``, and
+  ``custom_predicates``
+
+.. seealso:: See Also:
+    :ref:`Quick Tutorial View Classes <qtut_view_classes>`,
+    :ref:`Quick Tutorial More View Classes <qtut_more_view_classes>`, and
+    :ref:`class_as_view`
 
 Quick Project Startup with Scaffolds
 ====================================
@@ -641,8 +482,10 @@ configuration. This includes a new way of running your application:
 
 Let's look at ``pserve`` and configuration in more depth.
 
-.. seealso:: See Also: :ref:`project_narr` and
-   :doc:`../narr/scaffolding`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Scaffolds <qtut_scaffolds>`,
+    :ref:`project_narr`, and
+    :doc:`../narr/scaffolding`
 
 Application Running with ``pserve``
 ===================================
@@ -670,7 +513,8 @@ Most of the work, though, comes from your project's wiring, as
 expressed in the configuration file you supply to ``pserve``. Let's
 take a look at this configuration file.
 
-.. seealso:: See Also: :ref:`what_is_this_pserve_thing`
+.. seealso:: See Also:
+    :ref:`what_is_this_pserve_thing`
 
 Configuration with ``.ini`` Files
 =================================
@@ -717,8 +561,10 @@ Additionally, the ``development.ini`` generated by this scaffold wired
 up Python's standard logging. We'll now see in the console, for example,
 a log on every request that comes in, as well traceback information.
 
-.. seealso:: See Also: :ref:`environment_chapter` and
-   :doc:`../narr/paste`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Application Configuration <qtut_ini>`,
+    :ref:`environment_chapter` and
+    :doc:`../narr/paste`
 
 
 Easier Development with ``debugtoolbar``
@@ -770,7 +616,10 @@ you want to disable this toolbar, no need to change code: you can
 remove it from ``pyramid.includes`` in the relevant ``.ini``
 configuration file.
 
-.. seealso:: See Also: :ref:`pyramid_debugtoolbar <toolbar:overview>`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial
+    pyramid_debugtoolbar <qtut_debugtoolbar>` and
+    :ref:`pyramid_debugtoolbar <toolbar:overview>`
 
 Unit Tests and ``nose``
 =======================
@@ -821,7 +670,11 @@ Pyramid supplies helpers for test writing, which we use in the
 test setup and teardown. Our one test imports the view,
 makes a dummy request, and sees if the view returns what we expected.
 
-.. seealso:: See Also: :ref:`testing_chapter`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Unit Testing <qtut_unit_testing>`,
+    :ref:`Quick Tutorial Functional Testing <qtut_functional_testing>`,
+    and
+    :ref:`testing_chapter`
 
 Logging
 =======
@@ -864,7 +717,9 @@ visit ``http://localhost:6543`` your console will now show::
 
  2013-08-09 10:42:42,968 DEBUG [hello_world.views][MainThread] Some Message
 
-.. seealso:: See Also: :ref:`logging_chapter`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Logging <qtut_logging>` and
+    :ref:`logging_chapter`
 
 Sessions
 ========
@@ -911,9 +766,10 @@ Jinja2 template:
     :end-before: End Sphinx Include 1
 
 .. seealso:: See Also:
-   :ref:`sessions_chapter`, :ref:`flash_messages`,
-   :ref:`session_module`, and
-   :ref:`Beaker sessioning middleware <beaker:overview>`
+    :ref:`Quick Tutorial Sessions <qtut_sessions>`,
+    :ref:`sessions_chapter`, :ref:`flash_messages`,
+    :ref:`session_module`, and
+    :ref:`Beaker sessioning middleware <beaker:overview>`
 
 Databases
 =========
@@ -958,10 +814,12 @@ of the system, can then easily get at the data thanks to SQLAlchemy:
     :start-after: Start Sphinx Include
     :end-before: End Sphinx Include
 
-.. seealso:: See Also: `SQLAlchemy <http://www.sqlalchemy.org/>`_,
-   :ref:`making_a_console_script`,
-   :ref:`bfg_sql_wiki_tutorial`, and
-   :ref:`Application Transactions With pyramid_tm <tm:overview>`
+.. seealso:: See Also:
+    :ref:`Quick Tutorial Databases <qtut_databases>`,
+    `SQLAlchemy <http://www.sqlalchemy.org/>`_,
+    :ref:`making_a_console_script`,
+    :ref:`bfg_sql_wiki_tutorial`, and
+    :ref:`Application Transactions With pyramid_tm <tm:overview>`
 
 Forms
 =====
@@ -1020,9 +878,10 @@ widgets using attractive CSS from Bootstrap and more powerful widgets
 from Chosen.
 
 .. seealso:: See Also:
-   :ref:`Deform <deform:overview>`,
-   :ref:`Colander <colander:overview>`, and
-   `deform_bootstrap <https://pypi.python.org/pypi/deform_bootstrap>`_
+    :ref:`Quick Tutorial Forms <qtut_forms>`,
+    :ref:`Deform <deform:overview>`,
+    :ref:`Colander <colander:overview>`, and
+    `deform_bootstrap <https://pypi.python.org/pypi/deform_bootstrap>`_
 
 Conclusion
 ==========
diff --git a/docs/quick_tutorial/databases.rst b/docs/quick_tutorial/databases.rst
index 83cf33862..93a02ffc7 100644
--- a/docs/quick_tutorial/databases.rst
+++ b/docs/quick_tutorial/databases.rst
@@ -1,3 +1,5 @@
+.. _qtut_databases:
+
 ==============================
 19: Databases Using SQLAlchemy
 ==============================
diff --git a/docs/quick_tutorial/debugtoolbar.rst b/docs/quick_tutorial/debugtoolbar.rst
index 6c711e2f2..d25588c49 100644
--- a/docs/quick_tutorial/debugtoolbar.rst
+++ b/docs/quick_tutorial/debugtoolbar.rst
@@ -1,3 +1,5 @@
+.. _qtut_debugtoolbar:
+
 ============================================
 04: Easier Development with ``debugtoolbar``
 ============================================
diff --git a/docs/quick_tutorial/forms.rst b/docs/quick_tutorial/forms.rst
index 0328ef528..e8bc0c8b4 100644
--- a/docs/quick_tutorial/forms.rst
+++ b/docs/quick_tutorial/forms.rst
@@ -1,3 +1,5 @@
+.. _qtut_forms:
+
 ====================================
 18: Forms and Validation With Deform
 ====================================
diff --git a/docs/quick_tutorial/functional_testing.rst b/docs/quick_tutorial/functional_testing.rst
index c9c99d76f..205ddf5cb 100644
--- a/docs/quick_tutorial/functional_testing.rst
+++ b/docs/quick_tutorial/functional_testing.rst
@@ -1,3 +1,5 @@
+.. _qtut_functional_testing:
+
 ===================================
 06: Functional Testing with WebTest
 ===================================
diff --git a/docs/quick_tutorial/hello_world.rst b/docs/quick_tutorial/hello_world.rst
index 59e088a31..c7a8eaf5e 100644
--- a/docs/quick_tutorial/hello_world.rst
+++ b/docs/quick_tutorial/hello_world.rst
@@ -1,3 +1,5 @@
+.. _qtut_hello_world:
+
 ================================
 01: Single-File Web Applications
 ================================
diff --git a/docs/quick_tutorial/ini.rst b/docs/quick_tutorial/ini.rst
index 35d6b46cc..630b1faa5 100644
--- a/docs/quick_tutorial/ini.rst
+++ b/docs/quick_tutorial/ini.rst
@@ -1,3 +1,5 @@
+.. _qtut_ini:
+
 =================================================
 03: Application Configuration with ``.ini`` Files
 =================================================
diff --git a/docs/quick_tutorial/jinja2.rst b/docs/quick_tutorial/jinja2.rst
index 134ab39ca..40d941098 100644
--- a/docs/quick_tutorial/jinja2.rst
+++ b/docs/quick_tutorial/jinja2.rst
@@ -1,3 +1,5 @@
+.. _qtut_jinja2:
+
 ==============================
 12: Templating With ``jinja2``
 ==============================
diff --git a/docs/quick_tutorial/json.rst b/docs/quick_tutorial/json.rst
index c92e4eadd..ece8a61c0 100644
--- a/docs/quick_tutorial/json.rst
+++ b/docs/quick_tutorial/json.rst
@@ -1,3 +1,5 @@
+.. _qtut_json:
+
 ========================================
 14: Ajax Development With JSON Renderers
 ========================================
diff --git a/docs/quick_tutorial/logging.rst b/docs/quick_tutorial/logging.rst
index 123e8e314..0167e5249 100644
--- a/docs/quick_tutorial/logging.rst
+++ b/docs/quick_tutorial/logging.rst
@@ -1,3 +1,5 @@
+.. _qtut_logging:
+
 ============================================
 16: Collecting Application Info With Logging
 ============================================
diff --git a/docs/quick_tutorial/more_view_classes.rst b/docs/quick_tutorial/more_view_classes.rst
index 8b004f19d..2792869ac 100644
--- a/docs/quick_tutorial/more_view_classes.rst
+++ b/docs/quick_tutorial/more_view_classes.rst
@@ -1,3 +1,5 @@
+.. _qtut_more_view_classes:
+
 ==========================
 15: More With View Classes
 ==========================
diff --git a/docs/quick_tutorial/request_response.rst b/docs/quick_tutorial/request_response.rst
index fc5ea020d..504803804 100644
--- a/docs/quick_tutorial/request_response.rst
+++ b/docs/quick_tutorial/request_response.rst
@@ -1,3 +1,5 @@
+.. _qtut_request_response:
+
 =======================================
 10: Handling Web Requests and Responses
 =======================================
diff --git a/docs/quick_tutorial/requirements.rst b/docs/quick_tutorial/requirements.rst
index 8afb664d4..df63ff912 100644
--- a/docs/quick_tutorial/requirements.rst
+++ b/docs/quick_tutorial/requirements.rst
@@ -1,3 +1,5 @@
+.. _qtut_requirements:
+
 ============
 Requirements
 ============
diff --git a/docs/quick_tutorial/routing.rst b/docs/quick_tutorial/routing.rst
index bfae69615..54dff5c39 100644
--- a/docs/quick_tutorial/routing.rst
+++ b/docs/quick_tutorial/routing.rst
@@ -1,3 +1,5 @@
+.. _qtut_routing:
+
 ==========================================
 11: Dispatching URLs To Views With Routing
 ==========================================
diff --git a/docs/quick_tutorial/scaffolds.rst b/docs/quick_tutorial/scaffolds.rst
index c8f6d5c66..8ca2d27df 100644
--- a/docs/quick_tutorial/scaffolds.rst
+++ b/docs/quick_tutorial/scaffolds.rst
@@ -1,3 +1,5 @@
+.. _qtut_scaffolds:
+
 =============================================
 Prelude: Quick Project Startup with Scaffolds
 =============================================
diff --git a/docs/quick_tutorial/sessions.rst b/docs/quick_tutorial/sessions.rst
index 56980f6ee..ba26d0133 100644
--- a/docs/quick_tutorial/sessions.rst
+++ b/docs/quick_tutorial/sessions.rst
@@ -1,3 +1,5 @@
+.. _qtut_sessions:
+
 =================================
 17: Transient Data Using Sessions
 =================================
diff --git a/docs/quick_tutorial/static_assets.rst b/docs/quick_tutorial/static_assets.rst
index 3c029a6bd..19d33f00f 100644
--- a/docs/quick_tutorial/static_assets.rst
+++ b/docs/quick_tutorial/static_assets.rst
@@ -1,3 +1,5 @@
+.. _qtut_static_assets:
+
 ==========================================
 13: CSS/JS/Images Files With Static Assets
 ==========================================
diff --git a/docs/quick_tutorial/templating.rst b/docs/quick_tutorial/templating.rst
index 136a494a0..d73067f48 100644
--- a/docs/quick_tutorial/templating.rst
+++ b/docs/quick_tutorial/templating.rst
@@ -1,3 +1,5 @@
+.. _qtut_templating:
+
 ===================================
 08: HTML Generation With Templating
 ===================================
diff --git a/docs/quick_tutorial/unit_testing.rst b/docs/quick_tutorial/unit_testing.rst
index a71ad0097..73b33c588 100644
--- a/docs/quick_tutorial/unit_testing.rst
+++ b/docs/quick_tutorial/unit_testing.rst
@@ -1,3 +1,5 @@
+.. _qtut_unit_testing:
+
 ===========================
 05: Unit Tests and ``nose``
 ===========================
diff --git a/docs/quick_tutorial/view_classes.rst b/docs/quick_tutorial/view_classes.rst
index b55abf218..58ab43e40 100644
--- a/docs/quick_tutorial/view_classes.rst
+++ b/docs/quick_tutorial/view_classes.rst
@@ -1,3 +1,5 @@
+.. _qtut_view_classes:
+
 ======================================
 09: Organizing Views With View Classes
 ======================================
diff --git a/docs/quick_tutorial/views.rst b/docs/quick_tutorial/views.rst
index 78f038d91..15785e902 100644
--- a/docs/quick_tutorial/views.rst
+++ b/docs/quick_tutorial/views.rst
@@ -1,3 +1,5 @@
+.. _qtut_views:
+
 =================================
 07: Basic Web Handling With Views
 =================================