A few people on the use-revolution list recently have complained about the
1.0 version of the documentation. In the attempt to improve the docs, I'd
like to solicit more information from those who have found the docs
inadequate.
The complaint I'm hearing is about conceptual documentation - introductory
material, overviews of functionality, and general concepts, such as the
information in the Encyclopedia. However, a couple of posts have described
the documentation as though this material weren't there at all. (One poster
mentioned the language dictionary, glossary, and "how to" stack as though
this were all the documentation there were. Another spoke as though the
first of the six tutorials were all the non-reference information in the
docs. Another post spoke of having obtained an overview of REALbasic by
spending an hour skimming the documentation, but didn't mention having been
able to do the same with the equivalent parts of the Rev documentation.)
So I'm considering whether people:
- Have specific questions that aren't being answered by the encyclopedia
- Want the encyclopedia material, but haven't been able to find it
- Have found it but are not comfortable reading it through, for whatever reason
Obviously, my approach to improving the docs (more orientation info? better
navigation? format changes?) for these folks will vary depending on exactly
what problems people are having with this material, and only users of
Revolution can answer these questions. What's your view?
--
Jeanne A. E. DeVoto ~ [EMAIL PROTECTED]
http://www.runrev.com/
Runtime Revolution Limited - Power to the Developer!
