github-as-code icon indicating copy to clipboard operation
github-as-code copied to clipboard

Readily expose useful public documentation about about Github permissions and Terraform

Open BigLep opened this issue 5 months ago • 0 comments

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,

BigLep avatar Feb 08 '24 20:02 BigLep