Show the _actual_ permission property name in list of "Permissions for GitHub Apps" #33611
Open
1 task done
Labels
content
This issue or pull request belongs to the Docs Content team
rest
Content related to rest - overview.
waiting for review
Issue/PR is waiting for a writer's review
Code of Conduct
What article on docs.github.com is affected?
https://docs.github.com/en/rest/authentication/permissions-required-for-github-apps?apiVersion=2022-11-28#organization-permissions-for-webhooks
And possibly
https://docs.github.com/en/rest/authentication/permissions-required-for-fine-grained-personal-access-tokens?apiVersion=2022-11-28
What changes are you suggesting?
In addition to showing the "pretty name" for permissions, the docs need to also show the actual permission property name slug for each permission so users know which permission to pass when creating an Installation Access Token with permissions.
For example:
Fails to describe any where on this page, or in any of the pages related to the webhook docs (example), that the actual
permission
value is calledrepository_hooks
.All that is (insufficiently) shown is:
To be clear, I want to see
repository_hooks
somewhere on either one or both of those pages.Right now the list of permissions are hidden in this endpoint's documentation in a collapsed expandable that is hard to search for and does not pull up on Google search when searching for
"permissions available for github apps"
.Additional information
Thanks
The text was updated successfully, but these errors were encountered: