resolves STREAMS-39

accurate README.md
added javadoc header to all classes missing