[Zope] Zope needs a FAQ.

Martijn Faassen M.Faassen@vet.uu.nl
Tue, 02 Mar 1999 17:45:22 +0100


Martijn Pieters wrote:
> 
> At 16:34 02/03/99 , Pavlos Christoforou wrote:
>
> >Seems that the activity on the Zope list has exploded. A lot of the
> >questions I read in the posts have been raised many times in the past. I
> >believe a FAQ on the Zope site is neccessary.

[snip]

> I believe this is allready under construction:
> http://www.zope.org/Community/Services
> 
> By far from incomplete, but it is the right direction. I think Amos' FAQ tool
> should be utilized there somewhere, and maybe some people from this list
> willing to help out DC should fill it in, because it looks like Ken Manheimer
> (who has been charged with community communications) allready seems overloaded.

More generally speaking, we should be organizing the Zope documentation
project. There was word of it before, but haven't heard much on it
recently. In fact, the messages that I can find in my mailbox on it is
people saying we should start such a project :). I'd obviously be very
useful.

As an example: I myself have sent some (obscure) questions to the list
the week before last, and have only managed to receive an answer that
confused me more (I welcomed the answer though, of course!). I sent more
questions and observations last week, but haven't received answers yet
(perhaps it's because I'm doing something fundamentally wrong with Zope
but I'd like to hear it if that's so). Of course I'd like to see my
questions answered.

A FAQ would help filter out all the less obscure questions so that my
obscure questions might get answers. :)

So, the Zope Communication Project (hereby started if it doesn't exist
yet, this is open source after all :) should make its first priority to
create a fairly exhaustive FAQ. I currently have some time to invest in
the ZDP (he said, tempting fate; work's slow right now, but this can
change quickly).

Anyway, I'll help. If only with the *questions* side of the FAQ,
perhaps, but I can help. :)

Initial Plan of Action for the ZDP:

- Produce a fairly exhaustive FAQ, mining the mailing list for good
questions and answers.

- Organize the ZDP itself. :)

Regards,

Martijn