update readme and usablility improvements