I personally feel that the main problem with the API is that there is no tutorial showcasing the main aspects of the scripting capabilities, while guiding you through the basic objects and such. The prerequisite would be a basic knowledge of (object oriented) JavaScript. I know that there is a sort of tutorial where you analyze a noise generator, but what I'm talking about is a full tutorial.