WIP - Actions API documentation

Begin some documentation for the Actions API
@fwereade Thanks; I'd like to discuss internal vs. client API's with you next time we co-incide on IRC.

Per our discussion this morning I'll be adjusting this to match the expected API too.