Readily expose useful public documentation about about Github permissions and Terraform #112
Description
Whenever I have to engage more seriously with github-magement, I end up having to find and open the links below so I can make informed decision. I wish these links were more readily available when engaging with github-mgmt. I think the "easy" solution is just to have them in github-mgmt docs somewhere that is called out or dedicated (I haven't previously seen these links in the github-mgmt/docs, which is why I then turn to search engine.)
- Org-level permissions: https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#permissions-for-organization-roles
- Org base permissions: https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/setting-base-permissions-for-an-organization#setting-base-permissions
- Permissions for each repository role: https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#permissions-for-each-role
- Difference between team maintainer vs. member: https://docs.github.com/en/organizations/organizing-members-into-teams/assigning-the-team-maintainer-role-to-a-team-member
I also wish these reminders were more present:
- Terraform “push” corresponds with Github “write”.
- Terraform “pull” corresponds with Github “read”.
- Terraform members.admin correspond with Github "org owner" per https://registry.terraform.io/providers/integrations/github/latest/docs/resources/membership
I assume this isn't needed by someone who is more of a sysadmin, but I find the links above are all key for me as someone who looks at github-mgmt every few months,