I think the documentation is actually quite good. Its pretty much straight forward OOP: You have a bunch of objects represented on a map, which can be interacted with via properties and methods. And those properties and methods are described in the API reference.
If you are an experienced programmer you should know that this is how most API references work.
I have been playing this game for 3 days straight now and I have gotten freaking n o w h e r e. I have written thousands of lines of code which were almost completely obsolete as soon as i entered the next "stage" of the game and everything went to sh*t within minutes. But thats how it is... and isn't it a w e s o m e?? 
(BTW I am a CS graduate with multiple yrs of xp... so that is not the issue.)