[Zope3-dev] Z3 documentation

[Stephan Richter]

On Wednesday 02 April 2003 10:02, Jeffrey P Shell wrote:
> On Wednesday, April 2, 2003, at 02:13  AM, Steve Alexander wrote:
> >> 2. What is the primary target audience? E.g. Zope2 users? Zope2
> >> developers? General readers outside the Zope community? While well
> >> designed docs can certainly address the needs of multiple groups, it's
> >> generally helpful to identify a primary target.
> >
> > The main documentation should assume no knowledge of Zope 2 from the
> > reader. Many users of Zope 3 have not used Zope 2.
>
> I think that Zope 3 is different enough that even Zope 2 users would
> benefit from clear documentation removed from previous contexts.  And,
> as you point out below, I think that a "Zope 2 to Zope 3" translation
> guide would be nice, and could actually benefit by being able to focus
> on documenting the differences and telling the story in Zope 2 terms
> while not having to document all of Zope 3 at the same time.
>
> > There could be other documentation specifically to allow people to
> > reuse their knowledge of Zope 2 in the context of Zope 3.

I actually outlined the documentation this way already in the Wiki. BTW, I 
agree with all the suggestions and thoughts on this thread so far.

Regards,
Stephan
-- 
Stephan Richter
CBU Physics & Chemistry (B.S.) / Tufts Physics (Ph.D. student)
Web2k - Web Software Design, Development and Training