That particular method didn't make it into the
folder documentation - I just
added it. When looking for information on IOM objects (devices, triggers, etc.), the first place to look that should be complete (assuming we haven't missed something like getId) is in the
IOM Reference Documentation.
When you have questions about building a plugin, start with the
Plugin Developer's Guide.
The server plugin tutorial has some information in a more concise format, but it's duplicate of what should be available in other places. It's also very much a draft at this point. I think we've found that it's a bit less necessary since by the time most developers have the more specific questions they can usually find it in one of the example plugins in the SDK.
So, anyone doing serious development should read through the Developer's Guide and Reference, then skim the tutorials. Finally, the examples in the SDK provide well documented code that shows how to do much of what you're looking for. And of course there's nothing wrong with asking questions. In this case, it was good for everyone since we'd somehow missed documenting that method call.
Finally, AppleScript's documentation is basically equivalent to the Reference Guide - but because our API provides so much more functionality (that AppleScript couldn't) the documentation is necessarily more complex.