You know, I really like the unit we developed (though we still are adding / evolving), but I am not proud of the documentation with it.
We are actively re-writing it right now, and will continue to evolve it. We want the docs to be complete so customers can use more than the HTML interface, we want them to understand how to do things with the API, and why certain things happen.
So, I hear you guys, I agree, and we are working on it. We are not going to keep things hidden, we intend to have the full API available.
Expect a revised draft within less than a week, and until then, feel free to email me or post here with any specifics you would like to see.