Improve and clarify annotation docs