"Kenneth" <kdw### [at] gmailcom> wrote:

> In your opinion (and Bald Eagle's), is the documentation as-is clear enough to
> suggest this proper use? I feel like there is some 'explanatory key to
> understanding' that is missing there.

It's something that I've tried to point out before, in several areas, on several
topics.

A line or two of working code can save 1000 lines of "documentation" and another
week of newsgroup posts trying to figure out the syntax and application.

The documentation isn't too bad _if you already know what you're doing_ , but if
you're a new user trying to do something like this for the first time - it
really almost isn't helpful at all.

Throw a working scene in the distro, or have a few small "blurbs" that DO
something.
The optional macro parameters where "an argument can be omitted" - but you still
need to add in the comma for it, is a good example where it's very hard to
understand that from what's written in the docs.

Post a reply to this message