[Checkins] SVN: zope.event/branches/tseaver-new_style_docs/docs/ Start on documenting theory of operation.

[Tres Seaver]

Log message for revision 111183:
  Start on documenting theory of operation.

Changed:
  U   zope.event/branches/tseaver-new_style_docs/docs/index.rst
  A   zope.event/branches/tseaver-new_style_docs/docs/theory.rst

-=-
Modified: zope.event/branches/tseaver-new_style_docs/docs/index.rst
===================================================================
--- zope.event/branches/tseaver-new_style_docs/docs/index.rst	2010-04-20 18:58:49 UTC (rev 111182)
+++ zope.event/branches/tseaver-new_style_docs/docs/index.rst	2010-04-20 19:08:30 UTC (rev 111183)
@@ -17,6 +17,7 @@
    :maxdepth: 2
 
    usage
+   theory
    api
    hacking
 

Added: zope.event/branches/tseaver-new_style_docs/docs/theory.rst
===================================================================
--- zope.event/branches/tseaver-new_style_docs/docs/theory.rst	                        (rev 0)
+++ zope.event/branches/tseaver-new_style_docs/docs/theory.rst	2010-04-20 19:08:30 UTC (rev 111183)
@@ -0,0 +1,23 @@
+Theory of Operation
+===================
+
+.. note::
+
+   This section explains both why an applciation or framework might
+   publish events, and various ways the integrator might configure
+   the subscribers to achieve different goals.
+
+Outline
+-------
+
+- Events as decoupling mechanism.
+
+  - Injecting policy into reusable applications.
+
+  - Extending frameworks.
+
+- Event dispatch strategies
+
+  - Type-based dispatch, as used in ZCA
+
+  - Attribute-based / key-based dispatch