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

[REBOL] Incomplete Documentation was: [RE: Re: nntp question]

From: max:ordigraphe at: 31-Aug-2001 10:02

Ahem, Can I second the motion... sorry for the long post. I am a reboler since version 1.x and I am seriously addicted, there is no doubt on that. BUT, I do understand Mr. Petr Krenzelok's cause. I face the same problem EVERY single time I tackle a new coding problem and try to expand on my rebol knowledge. The PDF guide was a god send. But then, There should be 3 or 4 of such guides because its clear that currently There are MUCH MORE things under the hood of rebol than is documented. Not everyone has the time (Yes its PAINFULLY slow) nor the ability to deciphre code by printing it out... especially the code from RT which is quite frankly scary (although enlightning)! /View by itself is PAINFULLY under-documented. It seems that every serious question gets answered here on this list, but man... how did all of you guys (and gals ?) figure out all of this, imagine the time collectively used-up. Ayways, I'm just putting my vote for -EXPLICIT- and complete documentation (cause I'm sure RT monitors). maybe if enough of us manifest, more effort (i.e. time and money I guess) will be spent on this rebol problem... cause as Petr pointed out, Other next-generation languages get more documentation support... And I do think that this can be a factor in choosing to learn one of these languages... I learned rebol before I knew Python existed... but if I had known about both at the same time.... But then, Ive been an amigan since 1991 (programmed heavily on it :-) and I consider Carl A god ;-) ... so It feels like the same than back then... You -Know- its better... but its hard to explain -why- to others... remember trying to explain why multi-tasking was good... then you'd get a seriously stupid answer like: "yeah but you can only type at one place at a time so, what's the use?"... aarrgh! I don't think its normal to realise that a language is limited not by its features but by its documentation... What's the point in adding features few will use because -EXPLICIT- documentation exists for some selected topics only, like parsing which is VERY well documented (hey, I have to give credit where its due! :-). This is NOT a flame for RT, its just the expression of the only problem I face with rebol day in and day out. cheers! -Max Contrary to popular belief, Unix IS user-friendly... its just picky on who it considers a friend