[DOCS] Specify actual permissions needed by GitHub token

[jvassbo]

Is your documentation request related to a problem? Please describe.
The token doc page says "make sure to give the proper permissions to your GitHub token", but doesn't specify which permissions these are. By my experimentation pull-request: write is not enough to make this action close or convert stale PRs to drafts.

Describe the solution you'd like
In order to supply the action with a Principle of Least Privilege token, it would be very helpful to know what permissions are expected, and why.

[Sonia-corporation-bot]

Hello and thank you for your first contribution!

All contributions are welcome, just keep in mind following the contributing guidelines and to always respect the code of conduct!

Thank you!

Your @Sonia-corporation-bot 🚀

[jvassbo]

By using trail-and-error I was able to pinpoint which permissions are needed (to work on PRs) in my workflow, in case anyone stumbles upon this issue:

permissions:
  contents: read
  pull-requests: write
  repository-projects: read

[C0ZEN]

@jvassbo thank you, I will look into it and update the docs accordingly.

[Sonia-corporation-bot]

🎉 This issue has been resolved in version 2.5.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀