WIP - Actions API documentation

Begin some documentation for the Actions API
Please make the distinction between client APIs and internal APIs clear -- we want them on separate facades please.