Praise: Rev Documentation to the rescue

[Dennis Brown]

Ok all you first graders,

You need to learn to read this semester, so I want you all to go down  
to the library and find a book on grammar, a couple from the 'See  
Spot Run" series would also be a good choice, and by all means get a  
dictionary --you will need that for the alphabet and to build up your  
knowledge of words.  Now study these to learn how to read.  Don't  
worry if it seems hard, I will be here from 8 to 5 for you to ask  
questions, and I will almost always know what to say to help your  
progress.  If I am busy with someone else just take a number and I  
will get to you shortly.  Once a week we will all come together as a  
class to learn how to sound out words.

What is that?  Why can't I teach you all at the same time instead of  
individually?  Well it is because I am so busy answering individual  
questions I don't have any time left to organize all the information  
I know into a course plan.  Hurry up now, don't waste any more of our  
time with silly questions, you need to get hunting for information or  
you will never learn to read before the semester is up!

Food for thought,

Dennis

On Jul 25, 2005, at 7:30 PM, Michael J. Lew wrote:

> Oh dear, oh dear oh dear! What is it with people and the docs? The  
> docs work perfectly well when you know where to look for  
> information. That may not always be immediately obvious, but I  
> think that some don't spend enough time looking at the arrangement  
> of the information before they claim the docs are too hard, or a  
> bottleneck.
>
> In Rev it is very easy to experiment with commands to see how they  
> work. Try it.
>
> In Rev it is fairly easy to guess what a command might be. Just try  
> it out and see if it works. If it doesn't then type it into the  
> dictionary filter and see what comes up.
>
> This list is part of the effective documentation of Revolution  
> (look up "effective" keyword in the dictionary ;-). Ask a question  
> here and you will generally get a useful answer.
>
> Don't try to tell me that Rev is not good for non-professionals.  
> This list is full of non-professionals who are making good things  
> with it.
>
> Regards,
> Michael Lew