Re: Manual about the Zope Component Architecture

On 22/03/2009, at 11:40 PM, Kamon Ayeva wrote:

> Hi Hanno,
>
> My first feeling was that we should contribute to updating the Zope  
> documentation first (or in parallele).
> And I want to contribute.
> The way I see it is that Plone doc should link to the core "Zope 3"  
> doc being available on docs.zope.org, but we could have a manual on  
> plone.org which introduces Z3 techniques in the context of Plone and  
> makes a façade to Zope 3 docs.
>
> Let's find a way to make this work !

Linking is better than rewriting, but content aggregation would be  
even better. Automatically take the bits we need from the zope3 docs  
and embed the content into the plone.org (with attribution of course).
The reasons I personally think this is good
  - someone types in "component architecture plone" "browser view  
plone" etc, we really want them to find our manual first
  - someone clicks from plone.org to zope.org they might end up  
reading more than is relevant or even applicable and end up being  
confused.

Content aggregation is more effort but I think the end result would be  
worth it. I also don't think its as hard as it looks.

Let's find a way to make this work!


>
>
> On Sun, Mar 22, 2009 at 1:07 PM, Hanno Schlichting <[email protected] 
> > wrote:
> Hi.
>
> Israel Saeta Pérez wrote:
> > We're planning a manual about the z3 component architecture to  
> explain
> > Interfaces, Adapters, Utilities, Browser Views, etc.
>
> How does this relate the wealth of documentation available for Zope  
> itself?
>
> Like for example Baiju's ZopeGuide
> (http://wiki.zope.org/zope3/ZopeGuide) and the "Comprehensive Guide to
> Zope Component Architecture" (http://www.muthukadan.net/docs/zca.html)
>
> The Zope documentation efforts are a lot less structured, but it is
> possible to engage with them and especially Baiju is probably most
> interested in collaborating.
>
>
> Cheers,
> Kamon
>
> ------------------------------------------------------------------------------
> 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_______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs


------------------------------------------------------------------------------
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