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