[REBOL] Re: Incomplete Documentation/One Idea
From: max:ordigraphe at: 31-Aug-2001 12:54
> -----Original Message-----
> From: [rebol-bounce--rebol--com]
> [mailto:[rebol-bounce--rebol--com]]On Behalf Of
> Tim Johnson
> Sent: Friday, August 31, 2001 1:00 PM
> To: [rebol-list--rebol--com]
> Subject: [REBOL] Re: Incomplete Documentation/One Idea
>
> Much of the best "documentation" on rebol takes the form of
> messages in
> this mailing list.
>
> Maybe a "Killer App" would be
> a sophisticated way of "mining" the archives and creating docs from
> that. It could result in ["recipes" "hints" "tutorials" "etc"]
> I know that there is just a huge amount of resources in there.
But to mine data, you must know what the data is... in the case of the
the scripts, the scarse comments included in the scripts deal more with
the code at hand than the functions used...
Its almost impossible to create a filter or parser which collect only
documentation... cause it would have to "understand" what is being
said... and if we were currently able to go that far... I dont think we
would even need rebol... software would self-document itself and would
suggest ideas by themselves...
I think Rebol would be the native dialect used by your pet android or
cyborg house cleaner ;-)
ok, enough nonsense ;-) I really do think that there is a fabulous
amount of technology in the rebol script archive. The only way I can
see for us to use that in any automated manner, is to scan the words
used in the code and index them. Then build a global index which tells
you in which script that particular word is used with some sort of
advanced priority so that we find more relevent ideas in the first
scripts we look at...
is that cool?
-MAx