This will be cool to see. I hope there is a good mode architecture like P-ROC has. Hell, I wish that was available in Visual Pinball.
But yes, documentation can make or break an API. It might be powerful, robust, awesome,but if it can't be taught, nobody can utilize it.