Beginning the process of updating the API documentation for annotations

Change-Id: I9bb83392213d4d300a6be31a605e3c5923ec04fc