Merge of andrew-docs branch.

10 files changed, 39 insertions, 12 deletions

diff --git a/docs/tutorials/bfgwiki/authorization.rst b/docs/tutorials/bfgwiki/authorization.rst
index 13443ca53..b2c5330f6 100644
--- a/docs/tutorials/bfgwiki/authorization.rst
+++ b/docs/tutorials/bfgwiki/authorization.rst
@@ -11,6 +11,9 @@ allowing anyone with access to the server to view pages.
 *authentication*.  We'll make use of both features to provide security
 to our application.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org <http://docs.repoze.org/bfgwiki-1.2/authorization>`_.
+
 Configuring a ``repoze.bfg`` Authentication Policy
 --------------------------------------------------
 
diff --git a/docs/tutorials/bfgwiki/basiclayout.rst b/docs/tutorials/bfgwiki/basiclayout.rst
index f0bf8ced8..213f238fd 100644
--- a/docs/tutorials/bfgwiki/basiclayout.rst
+++ b/docs/tutorials/bfgwiki/basiclayout.rst
@@ -7,6 +7,9 @@ but they provide a good orientation for the high-level patterns common
 to most :term:`traversal` -based :mod:`repoze.bfg` (and :term:`ZODB`
 based) projects.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org <http://docs.repoze.org/bfgwiki-1.2/basiclayout>`_.
+
 ``__init__.py``
 ---------------
 
diff --git a/docs/tutorials/bfgwiki/definingmodels.rst b/docs/tutorials/bfgwiki/definingmodels.rst
index effbaa4bf..475e35442 100644
--- a/docs/tutorials/bfgwiki/definingmodels.rst
+++ b/docs/tutorials/bfgwiki/definingmodels.rst
@@ -11,6 +11,9 @@ objects.  A single instance of the "Wiki" class will serve as a
 container for "Page" objects, which will be instances of the "Page"
 class.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org <http://docs.repoze.org/bfgwiki-1.2/models>`_.
+
 Deleting the Database
 ---------------------
 
diff --git a/docs/tutorials/bfgwiki/definingviews.rst b/docs/tutorials/bfgwiki/definingviews.rst
index b8c1ef37b..72101d258 100644
--- a/docs/tutorials/bfgwiki/definingviews.rst
+++ b/docs/tutorials/bfgwiki/definingviews.rst
@@ -25,6 +25,9 @@ We're going to define several :term:`view callable` functions then
 wire them into :mod:`repoze.bfg` using some :term:`view
 configuration` via :term:`ZCML`.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org <http://docs.repoze.org/bfgwiki-1.2/views>`_.
+
 Adding View Functions
 =====================
 
@@ -232,11 +235,10 @@ Static Resources
 
 Our templates name a single static resource named ``style.css``.  We
 need to create this and place it in a file named ``style.css`` within
-our package's ``templates/static`` directory:
-
-.. literalinclude:: src/views/tutorial/templates/static/style.css
-   :linenos:
-   :language: css
+our package's ``templates/static`` directory.  This file is a little
+too long to replicate within the body of this guide, however it is
+available `online
+<http://docs.repoze.org/bfgwiki-1.2/views/tutorial/templates/static/style.css>`_.
 
 This CSS file will be accessed via
 e.g. ``http://localhost:6543/static/style.css`` by virtue of the
diff --git a/docs/tutorials/bfgwiki/index.rst b/docs/tutorials/bfgwiki/index.rst
index 4e6d9b306..3ba79b714 100644
--- a/docs/tutorials/bfgwiki/index.rst
+++ b/docs/tutorials/bfgwiki/index.rst
@@ -8,7 +8,9 @@ application to a developer familiar with Python.  When we're done with
 the tutorial, the developer will have created a basic Wiki application
 with authentication.
 
-Contents:
+For cut and paste purposes, the source code for all stages of this
+tutorial can be browsed at `docs.repoze.org
+<http://docs.repoze.org/bfgwiki-1.2>`_.
 
 .. toctree::
    :maxdepth: 2
diff --git a/docs/tutorials/bfgwiki2/authorization.rst b/docs/tutorials/bfgwiki2/authorization.rst
index ea4c7b4e4..7383fe327 100644
--- a/docs/tutorials/bfgwiki2/authorization.rst
+++ b/docs/tutorials/bfgwiki2/authorization.rst
@@ -13,6 +13,10 @@ continue allowing anyone with access to the server to view pages.
 *authentication*.  We'll make use of both features to provide security
 to our application.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org
+<http://docs.repoze.org/bfgwiki2-1.2/authorization>`_.
+
 Adding A Root Factory
 ---------------------
 
diff --git a/docs/tutorials/bfgwiki2/basiclayout.rst b/docs/tutorials/bfgwiki2/basiclayout.rst
index d882832d5..5392660da 100644
--- a/docs/tutorials/bfgwiki2/basiclayout.rst
+++ b/docs/tutorials/bfgwiki2/basiclayout.rst
@@ -6,6 +6,9 @@ The starter files generated by the ``bfg_routesalchemy`` template are
 basic, but they provide a good orientation for the high-level patterns
 common to most :term:`url dispatch` -based :mod:`repoze.bfg` projects.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org <http://docs.repoze.org/bfgwiki2-1.2/basiclayout>`_.
+
 ``__init__.py``
 ---------------
 
diff --git a/docs/tutorials/bfgwiki2/definingmodels.rst b/docs/tutorials/bfgwiki2/definingmodels.rst
index 0cae00ede..214a5e908 100644
--- a/docs/tutorials/bfgwiki2/definingmodels.rst
+++ b/docs/tutorials/bfgwiki2/definingmodels.rst
@@ -6,6 +6,9 @@ The first change we'll make to our stock paster-generated application
 will be to define a :term:`model` constructor representing a wiki
 page.  We'll do this inside our ``models.py`` file.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org <http://docs.repoze.org/bfgwiki2-1.2/models>`_.
+
 Making Edits to ``models.py``
 -----------------------------
 
diff --git a/docs/tutorials/bfgwiki2/definingviews.rst b/docs/tutorials/bfgwiki2/definingviews.rst
index db7dcfbe0..1d40d0051 100644
--- a/docs/tutorials/bfgwiki2/definingviews.rst
+++ b/docs/tutorials/bfgwiki2/definingviews.rst
@@ -29,6 +29,9 @@ invoked, matching this path, the matchdict dictionary attached to the
 request passed to the view would have a ``one`` key with the value
 ``foo`` and a ``two`` key with the value ``bar``.
 
+The source code for this tutorial stage can be browsed at
+`docs.repoze.org <http://docs.repoze.org/bfgwiki2-1.2/views>`_.
+
 Declaring Dependencies in Our ``setup.py`` File
 ===============================================
 
@@ -246,11 +249,10 @@ Static Resources
 
 Our templates name a single static resource named ``style.css``.  We
 need to create this and place it in a file named ``style.css`` within
-our package's ``templates/static`` directory:
-
-.. literalinclude:: src/views/tutorial/templates/static/style.css
-   :linenos:
-   :language: css
+our package's ``templates/static`` directory.  This file is a little
+too long to replicate within the body of this guide, however it is
+available `online
+<http://docs.repoze.org/bfgwiki2-1.2/views/tutorial/templates/static/style.css>`_.
 
 This CSS file will be accessed via
 e.g. ``http://localhost:6543/static/style.css`` by virtue of the
diff --git a/docs/tutorials/bfgwiki2/index.rst b/docs/tutorials/bfgwiki2/index.rst
index f97972766..42189f3e6 100644
--- a/docs/tutorials/bfgwiki2/index.rst
+++ b/docs/tutorials/bfgwiki2/index.rst
@@ -8,7 +8,9 @@ This tutorial introduces a :term:`SQLAlchemy` and :term:`url dispatch`
 Python.  When the tutorial is finished, the developer will have
 created a basic Wiki application with authentication.
 
-Contents:
+For cut and paste purposes, the source code for all stages of this
+tutorial can be browsed at `docs.repoze.org
+<http://docs.repoze.org/bfgwiki2-1.2>`_.
 
 .. toctree::
    :maxdepth: 2