updated doc for final state