update readme for public consumption