summaryrefslogtreecommitdiff
path: root/docs/narr/hybrid.rst
diff options
context:
space:
mode:
authorCasey Duncan <casey.duncan@gmail.com>2010-11-24 23:11:03 -0700
committerCasey Duncan <casey.duncan@gmail.com>2010-11-24 23:11:03 -0700
commitd3569c8d7c2367a5e81d2425adf5e0b2841efed5 (patch)
tree037dd7f71e9e28d01e32129e572b0c1777bf047b /docs/narr/hybrid.rst
parentd062f5d44ffc503cda7675389c58727d2b440f40 (diff)
downloadpyramid-d3569c8d7c2367a5e81d2425adf5e0b2841efed5.tar.gz
pyramid-d3569c8d7c2367a5e81d2425adf5e0b2841efed5.tar.bz2
pyramid-d3569c8d7c2367a5e81d2425adf5e0b2841efed5.zip
Clarify paragraph describing why Traversable is traversable
Diffstat (limited to 'docs/narr/hybrid.rst')
-rw-r--r--docs/narr/hybrid.rst16
1 files changed, 8 insertions, 8 deletions
diff --git a/docs/narr/hybrid.rst b/docs/narr/hybrid.rst
index a428ddc92..b90577a55 100644
--- a/docs/narr/hybrid.rst
+++ b/docs/narr/hybrid.rst
@@ -250,14 +250,14 @@ route configuration statement:
config.add_route('home', '{foo}/{bar}/*traverse',
factory='mypackage.routes.root_factory')
-The ``factory`` above points at the function we've defined. It
-will return an instance of the ``Traversable`` class as a root object
-whenever this route is matched. Because the ``Traversable`` object
-we've defined has a ``__getitem__`` method that does something
-nominally useful, and because traversal uses ``__getitem__`` to walk
-the nodes that make up an object graph, using traversal against the
-root object implied by our route statement becomes a reasonable thing
-to do.
+The ``factory`` above points at the function we've defined. It will
+return an instance of the ``Traversable`` class as a root object
+whenever this route is matched. Instances of the``Traversable`` class
+can be used for graph traversal because they have a ``__getitem__``
+method that does something nominally useful. Since traversal uses
+``__getitem__`` to walk the nodes of an object graph, using traversal
+against the root object implied by our route statement is a reasonable
+thing to do.
.. note::