>> R's internal documentation is designed as an
>> online reference, not a comprehensive guide. A dictionary of commands is
>> useful if one knows which command one needs. And the glossary is useful if
>> one is unfamiliar with elementary computing terms. A list of "how to" tips
>> mau be useful once one is operational.
> It's almost like we're looking at different products. I'm looking at the
> docs in the Rev Starter Kit 1.0. In addition to all of that, there are the
> tutorials which introduce the major features and the reasons they're
> important, and an introduction to Rev as a whole. Do you have those in your
> installation?
>From my own perspective two days after downloading Revolution, what's needed
online is also a thematic index to the Transcript dictionary as well as the
alphabetical index; same material, just a more convenient way to find what
you're looking for. I think both the SuperCard Language Reference stack and
RealBasic online help have a thematic index as well as alphabetical.
I would agree that the "comprehensive guide" kind of documentation with
Revolution is pretty lightweight. One of you is talking "hello world"
tutorials and the other is talking about a 300-page reference manual. I see
that you get printed docs with the Professional registration, so perhaps
those are the more comprehensive reference guides.
If so, what RealBasic has done in the documentation that was mentioned is
just release the PDF file for the book as a free download. I'm not sure
whether RR would want to do that or not. But with a thematic index, one
could get along pretty well in the Starter Kit and only need trial and error
or asking a question to find out details of how things work beyond what's in
the dictionary.
Curry Kenworthy
[EMAIL PROTECTED]
