summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2010-12-19 12:57:49 -0500
committerChris McDonough <chrism@plope.com>2010-12-19 12:57:49 -0500
commitfff2fa56041493715317470981435a0996f28e17 (patch)
treef62092b373c481e5882f45bd326d0cf078057dd5 /docs
parent4762ab91a3b624c877a9367d5c0141f51e7e0313 (diff)
downloadpyramid-fff2fa56041493715317470981435a0996f28e17.tar.gz
pyramid-fff2fa56041493715317470981435a0996f28e17.tar.bz2
pyramid-fff2fa56041493715317470981435a0996f28e17.zip
make a judgment
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/traversal.rst19
1 files changed, 10 insertions, 9 deletions
diff --git a/docs/narr/traversal.rst b/docs/narr/traversal.rst
index 48e90e4d9..4b45c543a 100644
--- a/docs/narr/traversal.rst
+++ b/docs/narr/traversal.rst
@@ -4,15 +4,16 @@ Traversal
=========
:term:`Traversal` It provides an alternative to using :term:`URL dispatch` to
-map a URL to a :term:`view callable`. It is a :term:`resource location`
-mechanism. It is the act of finding a :term:`context` resource by walking
-over a :term:`resource tree`, starting from a :term:`root` resource, using a
-:term:`request` object as a source of path information. Once a context
-resource is found, a view callable is looked up and invoked.
-
-In this chapter, we'll provide a high-level overview of traversal, we'll
-explain the concept of a resource tree, and we'll show how traversal might be
-used within an application.
+map a URL to a :term:`view callable`. It is the act of locating a
+:term:`context` resource by walking over a :term:`resource tree`, starting
+from a :term:`root` resource, using a :term:`request` object as a source of
+path information. Once a context resource is found, a view callable is
+looked up and invoked.
+
+Using :term:`Traversal` to map a URL to code is optional. It is often less
+easy to understand than URL dispatch, so if you're a rank beginner, it
+probably makes sense to use URL dispatch to map URLs to code instead of
+traversal. In that case, you can skip this chapter.
.. index::
single: traversal overview