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: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED] 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@lists.runrev.com > Please visit this url to subscribe, unsubscribe and manage > your subscription preferences: > http://lists.runrev.com/mailman/listinfo/use-revolution > _______________________________________________ use-revolution mailing list use-revolution@lists.runrev.com Please visit this url to subscribe, unsubscribe and manage your subscription preferences: http://lists.runrev.com/mailman/listinfo/use-revolution
