Incorrect doc of cedar_policy::Policy::annotation

[shaobo-he-aws]

Describe the improvement you'd like to request

The comment says that this function returns None only when the annotation is not present, which is not the case. It can also return None when the argument is not a valid Id.

IMO, we should change the signature of this function for the next major release and at least fix the comment now.

Describe alternatives you've considered

N/A

Additional context

No response

Is this something that you'd be interested in working on?

• 👋 I may be able to implement this internal improvement
• ⚠️ This feature might incur a breaking change

[john-h-kastner-aws]

good catch. It's also missing a period between policy and If

[john-h-kastner-aws]

and the comment on the function below needs a period between policy and Annotations