It's a step in the right direction. It just needs a blog to go with it. People read blogs, and the intention of what you are referencing to put technical mumbo jumbo back into digestable english.
Similarily how user interfaces go. "at a glance" you should know what you're looking at without further explanation.
It's all good stuff.. but what you've done is trimmed down the fat and given the raw data. Sometimes people into new things like seeing the fat too..
Actually this is all the fat. It's the sole interface for the blockchain we're building.
There's nothing more to see than this.
Maybe some code usage examples could help? The descriptions are fine. The parameters are fine. Usage examples or code examples might make it crystal clear? (or a demo script, etc)
OK I will build some go and js clients for it and show them off. That may not be till 3rd jan though-- I am headed home for christmas.