API/SPI Combination and Examples

Subset of discussion at https://github.com/reactive-streams/reactive-streams/pull/37
Work as a result of discussion in https://github.com/reactive-streams/reactive-streams/issues/19
Merge pull request #40 from reactive-streams/combine-api-spi

API/SPI Combination and Examples