Re: Documentation (was Re: [Chicken-users] How to use prelude?)

[Alejandro Forero Cuervo]

> I realize that the Python community is a a few orders of magnitude
> larger than Chicken's, but perhaps opening up the docs for community
> editing might alleviate the burden from Felix and the core
> developers?

That's precisely what I think.  Having a wiki could help improve the
quality of our documentation significantly.

On May the 23th I started one:

  http://chicken.freaks-unidos.net/

The contents of the wiki are stored in the wiki/ sub directory of the
eggs' Subversion repository (which means that anyone with access to
the repository can checkout a copy, work on them locally and then
commit changes).  There are more details about this:

  http://chicken.freaks-unidos.net/svn%20checkout

I plan to move the documentation for most of my eggs to it.  You can
see an example of an egg I've been documenting there:

  http://chicken.freaks-unidos.net/stream-ldif

For the sake of coherency I also wrote some guidelines on how to
document eggs, which are, of course, open to discussion:

  http://chicken.freaks-unidos.net/eggs%20guidelines

I created a page for users of Chicken Scheme.  Right now it feels a
little lonely, only listing me, but I would like to invite others to
join:

  http://chicken.freaks-unidos.net/users

Of course, the wiki engine is run by Chicken.  More documentation
about it is available here:

  http://wiki.freaks-unidos.net/svnwiki

So I want to invite you all to start contributing to the wiki.  I
think it could turn out to be a very useful resource and make using
Chicken even more pleasant than it already is.

Alejo.
http://azul.freaks-unidos.net/