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


- 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
+:Author: Jean-Marc Orliaguet
+:Version: $Revision: 1 $
+:Copyright: 2005 Nuxeo and Contributors.
+.. contents::
@@ -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, 
+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
+.. 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

Reply via email to