This adds a short explanation of the resource policy annotation.

Closes #1880