Merge branch 'topotween'

1 files changed, 8 insertions, 6 deletions

diff --git a/docs/glossary.rst b/docs/glossary.rst
index ccb62bbc8..f0ad81ded 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -920,11 +920,13 @@ Glossary
    tween
      A bit of code that sits between the Pyramid router's main request
      handling function and the upstream WSGI component that uses
-     :app:`Pyramid` as its 'app'.  A tween may be used by Pyramid framework
-     extensions, to provide, for example, Pyramid-specific view timing
-     support bookkeeping code that examines exceptions before they are
-     returned to the upstream WSGI application.  Tweens behave a bit like
-     :mod:`WSGI` 'middleware' but they have the benefit of running in a
+     :app:`Pyramid` as its 'app'.  The word "tween" is a contraction of
+     "between".  A tween may be used by Pyramid framework extensions, to
+     provide, for example, Pyramid-specific view timing support, bookkeeping
+     code that examines exceptions before they are returned to the upstream
+     WSGI application, or a variety of other features.  Tweens behave a bit
+     like :mod:`WSGI` 'middleware' but they have the benefit of running in a
      context in which they have access to the Pyramid :term:`application
-     registry` as well as the Pyramid rendering machinery.
+     registry` as well as the Pyramid rendering machinery.  See
+     :ref:`registering_tweens`.