improve the annotations doc