Praise: Rev Documentation to the rescue

[MisterX]

Hi Chipp

i agree that it's hard to write both software and documentation
but by far, the hardest is the documentation ;)

i find the rev documentation more than enough but my experience
is hardly a beginners'.

still i learned without books and always by disecting the stacks
i found - and i never stopped looking for new stacks. 

If there is one difference between rev and HC, it's the lack of
a home stack that guides you in all simplicity to the examples.

I know, there's the revonline, but it's hardly a nice and simple
example users can't go unlocking themselves...

As far as TAOO, well, i should finish it first - gather those users
that dont like reading documentation and see what's not clear...

Once that step is done, surely the docs authoring will be simpler ;)

cheers
Xavier  

> -----Original Message-----
> From: use-revolution-bounces at lists.runrev.com 
> [mailto:use-revolution-bounces at lists.runrev.com] On Behalf Of 
> Chipp Walters
> Sent: Tuesday, July 26, 2005 00:05
> To: How to use Revolution
> Subject: Re: Praise: Rev Documentation to the rescue
> 
> Dan Shafer wrote:
> 
> > Designing and writing good docs is nearly as hard as designing and 
> > writing good software.
> 
> I beg to differ! How many software products/code libraries do 
> you know of which don't even have documentation. Poor Xavier 
> and his TAOO project is a great example, while he has told us 
> some great ideas-- w/out *good* documentation, it's really 
> hard to follow... (no disrespect intended, X, I still love you;-).
> 
> In fact, without good documentation, much software is 
> rendered unusable. 
> A case might even be made that without the books authored by 
> the '3 Dans,' Hypercard may have never been adopted so widely.
> 
> best,
> 
> Chipp
> 
> _______________________________________________
> use-revolution mailing list
> use-revolution at lists.runrev.com
> Please visit this url to subscribe, unsubscribe and manage 
> your subscription preferences:
> http://lists.runrev.com/mailman/listinfo/use-revolution
>