- upgrade `BeforeTraversal` event in router.rst

1 files changed, 14 insertions, 15 deletions

diff --git a/docs/narr/router.rst b/docs/narr/router.rst
index d4c0cc885..e45e6f4a8 100644
--- a/docs/narr/router.rst
+++ b/docs/narr/router.rst
@@ -41,27 +41,26 @@ request enters a :app:`Pyramid` application through to the point that
    user-defined :term:`route` matches the current WSGI environment.  The
    :term:`router` passes the request as an argument to the mapper.
 
-#. If any route matches, the route mapper adds attributes to the request:
-   ``matchdict`` and ``matched_route`` attributes are added to the request
-   object.  The former contains a dictionary representing the matched dynamic
-   elements of the request's ``PATH_INFO`` value, and the latter contains the
+#. If any route matches, the route mapper adds the attributes ``matchdict``
+   and ``matched_route`` to the request object. The former contains a
+   dictionary representing the matched dynamic elements of the request's
+   ``PATH_INFO`` value, and the latter contains the
    :class:`~pyramid.interfaces.IRoute` object representing the route which
    matched.
-   
-   A :class:`~pyramid.events.BeforeTraversal` :term:`event` is sent to any
+
+#. A :class:`~pyramid.events.BeforeTraversal` :term:`event` is sent to any
    subscribers.
 
-   The root object associated with the route found is also generated:
-   if the :term:`route configuration` which matched has an associated
-   ``factory`` argument, this factory is used to generate the root object,
-   otherwise a default :term:`root factory` is used.
+#. Continuing, if any route matches, the root object associated with the found
+   route is generated. If the :term:`route configuration` which matched has an
+   associated ``factory`` argument, then this factory is used to generate the
+   root object; otherwise a default :term:`root factory` is used.
 
-#. If a route match was *not* found, and a ``root_factory`` argument was passed
+   However, if no route matches, and if a ``root_factory`` argument was passed
    to the :term:`Configurator` constructor, that callable is used to generate
-   the root object after a :class:`~pyramid.events.BeforeTraversal`
-   :term:`event` is sent to any subscribers.  If the ``root_factory`` argument
-   passed to the Configurator constructor was ``None``, a default root factory
-   is used to generate a root object.
+   the root object. If the ``root_factory`` argument passed to the
+   Configurator constructor was ``None``, a default root factory is used to
+   generate a root object.
 
 #. The :app:`Pyramid` router calls a "traverser" function with the root object
    and the request.  The traverser function attempts to traverse the root