[REBOL] Documentation: Let's do it NOW!
From: robert:muench:robertmuench at: 8-Aug-2003 9:00
> -----Original Message-----
> From: [rebol-bounce--rebol--com] [mailto:[rebol-bounce--rebol--com]]
> On Behalf Of Maxim Olivier-Adlhoch
> Sent: Thursday, August 07, 2003 7:28 PM
> To: [rebol-list--rebol--com]
> Subject: [REBOL] documentation [was: [RE: Re: [BUG?] read-io
> & write-io or Wait or is TCL better?]]
> rebol.com really needs a search engine, to which we can plug
> our own information (in any form: web refs, code, text, etc.).
Hi, just a note to all that might not follow Rebol from the beginning.
There is/was once a Rebol word dictonary Reblet that allowed to add your
own notes to each entry. You had a filter to select the words of some
category (like GUI, control, logic).
IMO this is the right way to go. Let's extend this Reblet with a central
P2P synced database that users can download/update. New entries should
pass a peer-review process to get into it. The mailinglist can be used
to discuss peer review rejected things. The idea of easy-vid, easy-draw
can be used to provide click-able examples. Lots of examples for each
word!
Further I think such a Reblet would perfectly fit into the library
project (this doesn't mean that the Library people should do it). The
dictonary Reblet could be extended with a library Reblet. With such a
tool, we have 80%+ of all required infos in one place. Next thing would
be to add tutorials etc.
It's like a coordinated WiKi idea. I still say that biggest problem of
Rebol is information fragmentation. New users need a lot of time to get
started. To much places to look at.
Anyway, I have written enough and to get things started now I'm doing
the first step: If no better suited person is found, I'm willing to
start and manage this project. But I won't do it only myself ;-). So,
who is going to join the project? Robert