updating documentation with animation option info