several fixes for annotation in docs page