[ZDP] Is there a plan for ZDP?

Martijn Faassen M.Faassen@vet.uu.nl
Thu, 06 May 1999 09:12:07 +0200


Craig Allen wrote:
> 
> I know folks are excited about building CoolFAQ, but what about other
> content and presentation methods?
> Looks like DC is pretty busy building stuff and preparing for the big
> 2.0 debut, maybe documentation is not their highest priority.  

> But I've
> found myself spending a lot of time trying to get beyond the basics
> without good documentation.  

Yes; Zope's still rough around the edges, I'd say. Especially the
documentation edges.

> I have some time and talent for
> documentation, but don't want to write something that may be duplicating
> what someone else is doing.  Besides, my knowledge is limited, so I'd
> need to work with others.  

I'll be glad to work with you, and I'm sure there are others!

> One thing I have done is glean various
> snippets of code and text from some of the mailing list messages, but it
> would require annotation to make it user friendly.

I agree.

> Is there an outline of the 'documentation architecture' for Zope?  Does
> anyone else think there should be?

There should be - the idea was to concentrate on the FAQ stuff first,
but we can diverge into other things just fine. If you come up with an
idea of what you would like to see, and how it would fit into the
'documentation architecture' (now an Official ZDP Word, we only need to
figure out what it means :) as a whole, please mail to this list. No, we
don't have a plan beyond CoolFAQ, but we'd like you to contribute one!
:) Any texts that you like to write; please send them to the list and
I'll help edit them if you like.

Regards,

Martijn