accurate README.md
added javadoc header to all classes missing
Merge branch 'STREAMS-39'