add javadocs
renamed README, add rest examples