[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
