udpated doc based on recent changes