update readme and inline docs