re #20 Activities API documentation.

Committed work done so far. This is still WIP.