From 7bc20e11b5ed7314e5aaed000242d4d5950fc775 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Fri, 3 Jul 2009 01:41:04 +0000 Subject: General editing walkthrough. --- docs/narr/hybrid.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) (limited to 'docs/narr/hybrid.rst') diff --git a/docs/narr/hybrid.rst b/docs/narr/hybrid.rst index 70a233005..129d76732 100644 --- a/docs/narr/hybrid.rst +++ b/docs/narr/hybrid.rst @@ -13,14 +13,15 @@ However, for some problems, it's useful to use both traversal *and* URL dispatch within the same application. :mod:`repoze.bfg` makes this possible. -Reasoning about a "hybrid" URL dispatch + traversal model is difficult -because the combination of the two concepts seems to break the law of -`the magical number seven plus or minus 2 +Reasoning about a "hybrid" URL dispatch + traversal model can be +difficult because the combination of the two concepts seems to fall +outside the sweet spot of `the magical number seven plus or minus 2 `_. -This is because, as a user, you need to understand 1) URL pattern -matching, 2) root factories and 3) the traversal algorithm, and the -interactions between all of them. Therefore, use of this pattern is -not recommended unless you *really* need to use it. +To reason successfully about using URL dispatch and traversal +together, you need to understand 1) URL pattern matching, 2) root +factories and 3) the traversal algorithm, and the interactions between +all of them. Therefore, use of this pattern is not recommended unless +you *really* need to use it. This is a advanced topic that has non-trivial corner cases; you may need to understand more deeply how :mod:`repoze.bfg` works to -- cgit v1.2.3