updated doc with animation methods