Re: Manual about the Zope Component Architecture
Anne Bowtell <[email protected]>
| Newsgroups | gmane.comp.web.zope.plone.documentation |
|---|---|
| Message-ID | <[email protected]> |
From an integrators' point of view, I'd be really keen to have a "lay-person's summary" at the beginning (or end) of each component section, perhaps also pointing to a particular example within the Plone core and explaining what it does. I'd be happy to try to contribute some of these. Anne Martin Aspeli wrote: > Israel Saeta Pérez wrote: > > >> You're right we should avoid duplicating what's already documented for >> Zope. I guess our intention here is trying to provide a soft >> introduction to the ZCA focusing on what's specifically relevant to >> Plone, and link Zope docs and doctest for further information. Something >> similar to chaper 9 of PPD. >> > > Mmmm.... You could just suggest people buy the book. ;) > > Seriously, though - I think it'd be better to create something > different, rather than try to replicate what's in PPD, only without the > copyright. > > My suggestion would be to focus on practical applications rather than go > into detail of theory. Chapter 9 of my book is pretty heavy going, and > only really helps those who've already got some taste of how things > work. Look at Brandon Craig Rhodes' "How to use Grok to walk like a > duck" tutorial, for example. It does a great job of building up *why* > things like adapters are useful, and where they may be used. I think a > series of examples built up like that, based on practical Plone use > cases, would add a lot of value. > > Martin > > ------------------------------------------------------------------------------ Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are powering Web 2.0 with engaging, cross-platform capabilities. Quickly and easily build your RIAs with Flex Builder, the Eclipse(TM)based development software that enables intelligent coding and step-through debugging. Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com