Mailing List Archive: 49091 messages
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search

[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<