improved JavaDocs
updated readme