add precaution to annotated docs