Complete documentation for Apache Storm integration

Related #267
Improve Storm integration tests (again)

This time broken out the Spout tests to address the 'synchronization'
issue between producer/consumer. Not fully addressed but overall seems
to work more reliably.
[DOC] Fix typo