[Checkins] SVN: bluebream/website/docs/v1.0/concepts.rst begin concepts
Baiju M
baiju.m.mail at gmail.com
Tue Jan 19 21:32:00 EST 2010
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.
More information about the checkins
mailing list