Initial pull request for SPI Documentation

Here's an initial pull request for the SPI documentation.

The strategy here is to simply walk users through the example-http connector (and eventually the cassandra connector).   The api.rst is an attempt to create an overview of the interfacts and each example section is an attempt to comment on and annotate the more important sections of the SPI.