Token permissions should link to more detailed information

[simonw]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/rest/actions/artifacts?apiVersion=2022-11-28#get-an-artifact

What changes are you suggesting?

On this page: https://docs.github.com/en/rest/actions/artifacts?apiVersion=2022-11-28#get-an-artifact

It says this:

The fine-grained token must have the following permission set:

• "Actions" repository permissions (read)

That's not quite enough information. I ended up having to add this YAML to my workflow to get a token that worked, for example:

permissions:
  actions: read

It would be useful if the text "Actions" repository permissions (read) included a link to super detailed documentation about that specific permission which included exactly how to issue tokens with it (ideally with screenshots of the UI because I always get lost in those kinds of interfaces) and details about what that looks like in YAML configuration too.

Additional information

No response