Re: Documentation lacking

[Lalo Martins <lalo at webcom dot com>]

On Sat, Jan 22, 2000 at 12:33:44AM -0800, thi wrote:
> 
> IMHO, (3) is most preferred, but historically guile development
> (including docs) has not held open arms to random passers-by.  i think
> this stance is ok for code, but for docs, it's extremely inhibiting, and
> leads to a lot of (4) happening.  that is, because guile is compelling
> enough (for some), people do take the trouble to dig through the source,
> but their hard-won insight is not captured due to high entry barrier to
> contribution.

What about writing a (web-based) repository for small doclets,
``howtos'', prototypes, specs, tips etc? Something along the
lines of the Zope HOWTO/Tip repository at
http://www.zope.org/Documentation . I can set such a thing up
on the Zope server I maintain at work.

[]s,
                                               |alo
                                               +----
--
      I am Lalo of deB-org. You will be freed.
                 Resistance is futile.

http://www.webcom.com/lalo      mailto:lalo@webcom.com
                 pgp key in the web page

Debian GNU/Linux       ---       http://www.debian.org
Brazil of Darkness   --   http://zope.gf.com.br/BroDar