Support read and write names for team repository permissions

[reiinoldo]

Accept read and write as UI-aligned aliases for pull and push in github_team_repository, normalize them for API calls, and suppress equivalent diffs. Update the docs and example and add unit and acceptance coverage. Validation passed: focused Go tests and tfplugindocs validation.

This is a proposal to fix the related issues:

• [FEAT]: treat equivalent permissions as equivalent (write == push) #2446
• [MAINT]: Missing distinction between roles and permissions #2508

Extra info:

• UI Roles
  • 
• https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization
• https://docs.github.com/en/rest/teams/teams?apiVersion=2026-03-10#add-or-update-team-repository-permissions

[github-actions]

👋 Hi, and thank you for this contribution!

This repo is maintained by GitHub and community members on a best-effort basis. We'll get to this as soon as we can.

You can help us prioritize by joining the discussion on open issues and PRs, sharing details on the changes you need, and reviewing other contributions.

---

_{🤖 This is an automated message.}