added some much needed documentation to the animation class