Added documentation

Hi,

I documented some stuff that was mentioned when we were trying to fix some of my annotations.

Please review and merge. Thanks!