[Checkins] SVN: bluebream/website/docs/v1.0/concepts.rst begin concepts

[Baiju M]

Log message for revision 108286:
  begin concepts
  

Changed:
  U   bluebream/website/docs/v1.0/concepts.rst

-=-
Modified: bluebream/website/docs/v1.0/concepts.rst
===================================================================
--- bluebream/website/docs/v1.0/concepts.rst	2010-01-20 00:52:56 UTC (rev 108285)
+++ bluebream/website/docs/v1.0/concepts.rst	2010-01-20 02:31:59 UTC (rev 108286)
@@ -1,17 +1,41 @@
 Concepts
 ========
 
-.. This chapter should provide an overview of BlueBream concepts.
-
 Interface
 ---------
 
+Interfaces are objects that specify (document) the external behavior
+of objects that "provide" them.  An interface specifies behavior
+through:
+
+- Informal documentation in a doc string
+
+- Attribute definitions
+
+- Invariants, which are conditions that must hold for objects that
+  provide the interface
+
+Some of the motivations for using interfaces are:
+
+- Avoid monolithic design by developing small, exchangeable pieces
+
+- Model external responsibility, functionality, and behavior
+
+- Establish contracts between pieces of functionality
+
+- Document the API
+
 Event
 -----
 
+Events are objects that represent something happening in a system.
+They are used to extend processing by providing processing plug
+points.
+
 Adpater
 -------
 
+
 Utility
 -------
 
@@ -24,21 +48,18 @@
 ZCML
 ----
 
+The Zope Configuration Markup Language (ZCML) is an XML based
+configuration system for registration of components.  Instead of
+using Python API for registration, you can use ZCML
+
 WSGI
 ----
 
-PasteScript
------------
-
-PasteDeploy
------------
-
-Buildout
---------
-
 ZODB
 ----
 
+Python based object database.
+
 Object Publishing
 -----------------
 
@@ -71,3 +92,6 @@
 
 Viewlet
 -------
+
+Viewlets provide a generic framework for building pluggable user
+interfaces.