readme: document desired API

I realize that start() and stop() are not yet implemented.
Patch welcome!