After having much difficulty using the API classes from a programmatic standpoint, I've summarized my complaints into bug 10602:

http://bugzilla.wikimedia.org/show_bug.cgi?id=10602

If you have any thoughts, please feel free to post a comment there. :)

-- Jim R. Wilson (jimbojw)