Document what to do about the deprecated annotations