Added few notes to readme and enhanced javadocs