Improve animate function docs
Merge pull request #244 from gameclosure/better-animate

Improve animate function docs