Author: jmorliaguet
Date: Tue Oct 25 15:42:24 2005
New Revision: 28616

Modified:
   z3lab/z3ecm/trunk/src/ecm/Makefile
   z3lab/z3ecm/trunk/src/ecm/cpsskins/README.txt
   z3lab/z3ecm/trunk/src/ecm/cpsskins/example1/README.txt
Log:

- doc updates



Modified: z3lab/z3ecm/trunk/src/ecm/Makefile
==============================================================================
--- z3lab/z3ecm/trunk/src/ecm/Makefile  (original)
+++ z3lab/z3ecm/trunk/src/ecm/Makefile  Tue Oct 25 15:42:24 2005
@@ -10,4 +10,4 @@
 
 
 .PHONY: cpsskins
-cpsskins: cpsskins/example1/README.html
+cpsskins: cpsskins/README.html cpsskins/example1/README.html

Modified: z3lab/z3ecm/trunk/src/ecm/cpsskins/README.txt
==============================================================================
--- z3lab/z3ecm/trunk/src/ecm/cpsskins/README.txt       (original)
+++ z3lab/z3ecm/trunk/src/ecm/cpsskins/README.txt       Tue Oct 25 15:42:24 2005
@@ -1,7 +1,16 @@
 
+.. header:: cpsskins developer tutorial
+
 CPSSKINS DEVELOPER TUTORIAL
 ===========================
 
+:Author: Jean-Marc Orliaguet
+:Version: $Revision: 1 $
+:Copyright: 2005 Nuxeo and Contributors.
+
+.. contents::
+
+
 Introduction
 ------------
 
@@ -15,13 +24,54 @@
 designer. Hence before reading this tutorial you should familiarize yourself
 with the UI.
 
+The CPSSkins model
+------------------
+
+CPSSkins departs from the traditional page templating approach used in
+creating web sites.
+
+When designing a site using page templates designers and programmers usually
+work on a same page. The separation of concerns mostly addresses the
+distinction between content and presentation.
+
+With CPSSkins designers work on the *elements* that make the page, the
+separation of concerns addresses all aspects of page designs (portlets, 
widgets,
+style, effects, ...). There could in theory be a 'widget designer', a 'portlet
+designer', an 'effect designer', ... and someone finally responsible for
+putting all the pieces together.
+
+To give an illustration, in order to draw a green tree on top of a hill using
+page templates, some 'hill designer' would start by drawing a hill on a blank
+page, some 'tree designer' would add a tree on top of the hill created by the
+'hill designer'. Finally some 'style designer' would paint the tree green using
+stylesheets, etc.
+
+In CPSSkins the approach for the same result would be:
+
+development phase
+~~~~~~~~~~~~~~~~~
+Some developer or a group of developers create:
+
+- a tree
+- a hill
+- a "tree painting filter"
+
+composition phase
+~~~~~~~~~~~~~~~~~
+
+- a page designer opens a new page, then drags the hill and the tree onto the
+  page canvas, associates a "tree painting filter" to the tree and moves the
+  tree just above the hill.
+
 
 Target audience
 ---------------
 
-The tutorial is targeted towards experimented integrators (a.k.a
-"super-integrators"). Before proceeding with this tutorial you should have a
-good knowledge of:
+The tutorial is targeted towards the developers who create the elements that
+are to be used by site, page or UI designers.
+
+These are experimented integrators (a.k.a "super-integrators").
+Before proceeding with this tutorial you should have a good knowledge of:
 
 - the Python language
 
@@ -177,3 +227,6 @@
 C) How to write a filter
 
 TODO
+
+
+.. footer:: copyright 2005 - Nuxeo and Contributors

Modified: z3lab/z3ecm/trunk/src/ecm/cpsskins/example1/README.txt
==============================================================================
--- z3lab/z3ecm/trunk/src/ecm/cpsskins/example1/README.txt      (original)
+++ z3lab/z3ecm/trunk/src/ecm/cpsskins/example1/README.txt      Tue Oct 25 
15:42:24 2005
@@ -1,5 +1,5 @@
 
-.. header:: cpsskins tutorial
+.. header:: cpsskins developer tutorial
 
 Example 1: Hello portlet
 ========================
-- 
http://lists.nuxeo.com/mailman/listinfo/z3lab-checkins

Reply via email to