[Zope3-dev] initial topics for z3 doc project

[Martijn Faassen]

Guido van Rossum wrote:
> > i really, really want the focus of the doc group at the sprint to be
> > on narrative docs, that capture the semantics of zope3.
> 
> Yesssss!  We need narrative docs.  And please make them
> self-contained, i.e. no references to how things were in Zope 2.

That's a good point. I think references to the way how things were
in Zope 2 are useful, but they should be relegated to either a
seperate document or a bunch of notes. Actually a comparison
'zope 2 does this, zope 3 does this' would not be a bad document to
have, but it should be quite apart from the self-contained documentation.

Regards,

Martijn