Document the new access policy API

This to help plan where on drupal.org the new docs should go?

Yeah, it's to have the documentation available already for review while we figure out where to put this once/if the work is committed :)

This seems like a perfect new feature for the announcement feed module btw

Read this a few times and the related issues are still in RTBC, so lets just add this there too.

As far as spot I would assume we would add a new entry to the API section on https://www.drupal.org/documentation →

Personally I would like to see it highlighted in some way, where announcement feed may be useful.

Added this here https://www.drupal.org/docs/develop/drupal-apis/the-access-policy-api →

Automatically closed - issue fixed for 2 weeks with no activity.

Changing to latest version when this was fixed and updating credit.