perl-modperl-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From f..@cliwe.ping.de (Frank D. Cringle)
Subject Re: mod_perl Documentation..
Date Thu, 04 Feb 1999 11:14:12 GMT
Doug MacEachern <dougm@pobox.com> writes:
> >Ofcourse any help and ideas are welcome. Doug what do you think, how do we
> >solve this "controversy"? I just wanted to avoid having another copy of
> 
> >docs which is similar but different, so the reader will be not confused. 
> >I'm not sure what's better many docs scattered around or no docs at all. 
> 
> most certainly, I think another copy should be avoided.  if you guys
> somehow built a system to hold the raw doc data, then have multiple
> interfaces to that data base (i.e. guide, faq-o-matic), that would be extra
> cool :)  seems like a "more effort than its worth" situation.  clearly,
> there is already overlap between the mod_perl docs, the faq and the guide,
> would be nice to somehow reduce that duplication.  

I don't think duplication can or should be avoided.  Docs, guide, faq
and book all provide information at different levels of detail for
different audiences - well, for the same audience in different
contexts.  Starting out with mod_perl?  Sit down and read the guide
from start to finish.  Got a problem?  Grep the faq for a couple of
keywords before asking on the mailing list.

That's not to say that things can't be improved.  I am certainly aware
that I haven't been maintaining the faq very diligently, and I have a
suitably guilty conscience about that :-)

-- 
Frank Cringle,      fdc@cliwe.ping.de
voice: (+49 2304) 467101; fax: 943357

Mime
View raw message