Improved annotations documentation

I'm a new contributor so sorry if I've got anything wrong, I've updated the annotations documentation page because I was trying to use it recently and found it unclear. I have improved some of the English and fixed some errors whilst also making it more clear.