Rev Documentation (was: icons)

[Martin BLACKMAN]

I will stick up for Revolution and say that as a relative newbie for
the most part I find the documentation to be excellent.  OK maybe the
section on icons is lacking, but for most keywords or functions you
get a very clear and logical explanation of the syntax including
inputs and outputs, what happens if an input is missing/empty, what
happens if an error occurs, a few example uses of the keyword or
function, hints or alerts to watch out for and 'see also' suggestions.
 I find it worthwhile to do a bit of 'surfing' from one item to
another by following the 'see also' suggestions. In this way when I
need to find out about an aspect of transcript I try to learn about
others as I go.

regards
Martin Blackman


> Message: 14
> Date: Fri, 17 Jun 2005 22:37:50 +0200
> From: Klaus Major <klaus at major-k.de>
> Subject: Re: icons
> To: How to use Revolution <use-revolution at lists.runrev.com>
> Message-ID: <5B716AA2-FB0C-41BB-9F1A-76A147650797 at major-k.de>
> Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed
> 

> > If you love Rev, and if you want it to be adopted widely, then
> > there is no way that the current documentation is adequate.
> 
> Sure, but that is not in any way affected by my attidtude, see above!
> 
> Again, the docs are not THAT bad, in opposite, they are excellent,
> but canot cover ALL aspects, since Rev is SO powerful, i think...
> 
> And like the engine, the docs are also a "work in progress" and get
> better with each release!
> 
> > end-rant...
> 
> Hark, hark! :-)
> 
> > :)
> >
> > Jon
> 
> Best from germany
> 
> Klaus Major
> klaus at major-k.de
> http://www.major-k.de