[REBOL] Re: Cookbook submissions idea
From: robert:muench:robertmuench at: 6-Jan-2004 14:24
On Tue, 6 Jan 2004 05:27:00 EST, <[SunandaDH--aol--com]> wrote:
> Robert Muench proposed REBOLDOC sometime back. That would be a website
> with extended user-contributed examples and documentation for each REBOL
> word -- so you could look up various tricks and traps for say 'if or
> 'open.
>
> He asked for volunteers to help him develop it back in aug-2003. If the
> project is onhold awaiting a kindly volunteer maybe, Gerard, you could
> be The One!
Hi, yes that's right. Even I'm going to repeat myself here over and over.
IMO the biggest enemy is "information fragmentation". We have a lot of
information burried in the ML, many very good Rebolers in the community,
several good web-sites, etc. We just don't consolidate these information
snippets in a central base.
For reference IMO it's a must to have a central base. The Rebol library
shows how good this approach works. The idea to send a status mail to the
ML is very good! With the ciritical mass of information, gravity will
ensure that more and more is put into the library / docs.
Anyway, I see some requirements that must be fullfiled to make this a
success:
1. Easy to use! New Rebolers, people just giving it a try, etc. want to
download one file and click thru it. I can imagine something like a
standalone easy-vid application. I have the SDK so we can create this. Of
course the source version will be available too but new people need to
get it
very fast.
2. Some Master! IMO we shouldn't spend to much time to questions like:
What categories do we need
, "In which order do we add content" etc. We
need someone how has the vision, and how keeps the rest of us on track. If
people submit stuff for Rebol words, well than we just use it. Over time
it will fill up. This is not a static project.
3. Make it pure Rebol! IMO the best we can do to show what Rebol is about
is to create an super-easy-vid like tool for all kind of Rebol
documentation: Core, View, VID, IOS etc. The Rebol knowledge-base...
4. Peer-Reviewing! The Master is responsible to share the vision and keep
the rest on track, motivate people and get input. To ensure a good
quaility, I think we should setup a peer-review group. This group will
check new submissions, before these are integrated. Peer-review members
should be suggested and voted on.
As I'm far away from being a Rebol expert WRT to View & VID, I just
started together with Steve, to collect all kind of information snippets
about View / VID. We try to hack together an as-much-complete
documentation as possible. I could need such a thing very often, as I'm
not working with this stuff all the time and I'm forgetting things to
fast. But I'm able to pick up very fast, if I can have a look at very
simple examples.
So, what do we do next? Robert<