Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[DOCS]: enforce_admins description understates what it covers and omits push restrictions

Open Beginner friendly
#3,707 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@dav-tb is already working on this.

Since Oct 30, 2026.

  • #3708 by @dav-tb — open

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
go, terraform
Domain
documentation

Research direction

Update the descriptions of enforce_admins in github_branch_protection and github_branch_protection_v3. Start by locating those resource descriptions and checking the linked GitHub documentation for the stated scope and bypass behavior. Done when the descriptions explain which protections apply to administrators, exclude push restrictions, and clarify that bypass lists still apply when enforce_admins is true.

Written by the indexing model from the issue text.

Description

Describe the need

github_branch_protection and github_branch_protection_v3 describe enforce_admins as enforcing "status checks for repository administrators". It actually applies most of the branch protection to administrators (pull request, linear history, signed commit and lock requirements too), but not push restrictions, which administrators can always bypass.

The bypass lists also don't say whether they still apply when enforce_admins is true. They do.

Code of Conduct
  • I agree to follow this project's Code of Conduct
Dominant language
Go
Stars
1.2k
Forks
1.1k
Avg merge
9h 41m
Merged PRs (30d)
3

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from integrations/terraform-provider-github

All issues in integrations/terraform-provider-github

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.