At 12:29 PM -0700 8/21/2001, Curry Kenworthy wrote:
>I think there could be some simple but effective improvements to the way the
>online reference is organized (alternate sets of organization and redundant
>ways to access items from related items in different sections). I like the
>way the "see also" index in the dictionary also refers to some explanation
>pages; there could be more of that, and vice versa--keywords could be listed
>in encyclopedia sections too.
If by "keyword" you mean a language word, they are, actually - any topic in
the docs can appear in the See Also list of any other topic, and I think
all the Encyclopedia topics except the "for new developers" ones list one
or more language terms under See Also.
>A PDF file would be nice, or the ability perhaps to browse the online
>documentation (and print it) as a book, in page order rather than as pure
>hypermedia. Different people really do access information in significantly
>different ways--for myself, I hardly ever touched any of the hefty printed
>books that come with products, and usually use something like the dictionary
>rather than the encyclopedia or PDF--but of course, many people like just
>the opposite, to read an encyclopedia reference from cover to cover before
>beginning.
This is of course a good point. Different people have different learning
styles. I've provided a linear path through introductory material under
"For New Developers" (in the main Documentation window), though I can see
some people would be more comfortable with a single document.
>about a feature after working with it extensively. (And making it so that a
>character is not inserted in the script when the help key is pressed.)
Oops. That one's a bug.
Thanks for the thoughtful comments.
--
Jeanne A. E. DeVoto ~ [EMAIL PROTECTED]
http://www.runrev.com/
Runtime Revolution Limited - Power to the Developer!
