Incomplete Documentation was: [RE: Re: nntp questio n]
[1/1] from: mario::cassani::icl::com at: 31-Aug-2001 15:28
Hi all, must reply quicly and shortly.
> 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)!
As Maxim told documentation is a must. What about RT "asking" the support of the mailing list? I tried to imagine the time * number of messages and the 50 lire (or 2 cents, if you like) idea is this: - RT makes a very complete manual index for /view in make-doc style exactly like for the /core PDF and this index is put on rebol.com - The list of 'word(s) and arguments listed in the index is saved in a text file on rebol.com - When someone asks something the one able to reply can send a copy to [manual--rebol--com] with a subject containing the 'word(s) and arguments of the index named above
> of you guys (and gals ?) figure out all of this, imagine the time > collectively used-up.
One minute more when someone sends a solution, collectively used-up can make the missing RT time for making docs. In addition they have not to lose time to send back the same info next time some newbie ask the same question. The best could be: RT makes a REBOL script similar to the feedback so solutions can be sent as paragraphs of the manual. A prize from RT to the main manual contributors is needed too ;) Maybe I'm a dreamer, but reading /view docs actually looks like a dream... Zaijian Mario