[ZDP] FYI: Documentation Futures

[Alexandre Ratti]

Hello,


I'll second Amos here. We'd need a peer review process for howtos so that 
new users who want to write one can feel more confident about there writings.

Writing a howto is very useful both for the writer and other users, but you 
don't want your misconceptions to end up in the final docs.

Recently I've sent notices about my draft howtos to the zope@zope.org list 
and I got useful feedback. However, postings have a fairly short lifetime. 
We'd need to post drafts somewhere so that they stay up a bit longer before 
released.

Also, the process could involve collective discussions of suggested changes 
and additions.

ZDPists, I've been reading your posts for some time. Keep up the good work!


Alexandre


At 12:00 26/10/1999 -0700, you wrote:
>From: Amos Latteier <Amos@digicool.com>
>To: "'Tom Deprez'" <tom.deprez@village.uunet.be>
>Cc: "'zdp@zope.org'" <zdp@zope.org>
>Subject: RE: [ZDP] FYI: Documentation Futures
>Date: Mon, 25 Oct 1999 18:07:04 -0400
>charset="iso-8859-1"
>
>Tom Deprez wrote:
>
> > Wow, nice to hear this!! (my opinion)
> >
> > * Does this seem like a good general direction?
> >
> > I think so. What I liked about the new Zope site was that
> > people actually
> > wrote HowTo's!
>
>I like this too. I think community members have generated a lot of good
>material via How-Tos. On addition to How-To's that I'd like to see is
>some kind of peer review process to make it easier for folks to make
>comments on a How-To, so that the author knows that someone is reading,
>and so that folks who have questions or find problems can easily alert
>the author.