updated readme and inline docs