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

[REBOL] Re: Dialect: graphics for Charts, Diagrams, Graphing ?

From: ddalley:idirect at: 20-Nov-2001 12:08

Hello, Jason: On 17-Nov-01, Jason Cunliffe wrote: (I wrote:)
> > > No, I mean that most of the program samples that I saw on the REBOL > > > site have no comments at all in their code, to document what > > > *exactly* is going on. > Titling and Commenting are fine arts unto themselves. Apart from much needed > in-line comments throughout the library examples, what would be really great > is more 'live' documentation like: > http://www.rebol.com/view/docs/../demos/easy-vid.r
Good point!
> Being able to click on the gray highlighted source code examples and have > the real results pop up like that while following a presenter's narrative > thread is something teachers and computer literacy evangelists and > developers dream of! REBOL could make itself incredibly attractive to > schools and others if it were developed just even a little bit further in > these directions.
I didn't realize fast enough just how important this doc was, until you pointed out its benefits. Having tried to self-learn and even teach a small number of programming languages, over nearly 20 years, I can state you are 100% correct - instant, intelligent responses, from the point of input, makes learning much faster. It sounds as if you have "been there - done that", too. Good documentation takes time & effort, but it is important. Having a way for us users to add or modify RT's docs, might speed up this necessary process. -- ---===///||| Donald Dalley |||\\\===--- The World of AmiBroker Support http://webhome.idirect.com/~ddalley UIN/ICQ#: 65203020