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

[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