Document the action implementation

[mellistibco]

Current behavior:
We do not have any documentation for the action implementation.

Expected behavior:
A definition of how the action implementation works

• how to define events
• that all input needs to map into a property called values
• that the handler name is used to correlate the incoming event typ, etc

What is the motivation / use case for changing the behavior?
Getting started is difficult without documentation