[REBOL] Re: Dialect: graphics for Charts, Diagrams, Graphing ?
From: ddalley:idirect at: 20-Nov-2001 12:08
On 17-Nov-01, Jason Cunliffe 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:
> 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