updated doc based on recent changes