git: 108aa45d57 - main - internal/resources: Expand the commit bit and resources policy

The branch main has been updated by jrm:

URL: https://cgit.FreeBSD.org/doc/commit/?id=108aa45d57447755c729f0e217375d94609856f5

commit 108aa45d57447755c729f0e217375d94609856f5
Author:     Joseph Mingrone <[email protected]>
AuthorDate: 2026-08-13 17:35:45 +0000
Commit:     Joseph Mingrone <[email protected]>
CommitDate: 2026-08-19 00:19:04 +0000

    internal/resources: Expand the commit bit and resources policy
    
    Elaborate on how the core team delegates management of
    repository-specific resources, such as commit bits, to the responsible
    teams.
    
    Add guidelines for suspending or revoking a commit bit: except where
    circumstances justify immediate action, teams are expected to contact
    the committer and provide an opportunity to address the problem before
    acting, and to inform both the committer and the core team when a commit
    bit is suspended or revoked.
    
    Reviewed by:    core (adrian, imp)
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D58830
---
 website/content/en/internal/resources.adoc | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/website/content/en/internal/resources.adoc b/website/content/en/internal/resources.adoc
index 82066ae046..e0aeba6759 100644
--- a/website/content/en/internal/resources.adoc
+++ b/website/content/en/internal/resources.adoc
@@ -7,10 +7,18 @@ include::shared/en/urls.adoc[]
 
 = Commit Bit and Project Resources Policy
 
-== Rationale
+The core team has sole authority for managing access to project resources, including granting and revoking both commit bits and user accounts.
 
-The core team manages access to project resources including granting and revoking both commit bits and user accounts. Core may delegate portions of these tasks to other groups or individuals at its discretion. For example, certain commit bits are managed by other groups as noted in link:{committers-guide}#committer.types[Commit Bit Types] subject to core's final approval. The core team has held this authority since its inception, but wanted to make it explicit to avoid confusion. The FreeBSD Core team approved the following commit bit and project resources policy which was posted to the Developers mailing list on August 4, 2011.
+== Delegation
 
-== Policy
+Under normal circumstances, the core team delegates management of repository-specific resources to link:{committers-guide}#committer.types[the responsible team] as long as the core team is kept informed of all decisions to grant, suspend, or revoke access.
+While the core team reserves the right to review and modify any decision, it prefers to defer to its delegated partners whenever possible.
 
-The core team has sole authority for managing access to project resources. This includes granting and revoking both commit bits and user accounts.
+== Guidelines
+
+A commit bit may be suspended or revoked for link:../expire-bits[inactivity], link:../code-of-conduct[conduct violations] or other link:../policies[policy violations], or actions that put the integrity of a repository at risk.
+Unless the circumstances justify immediate action, such as a compromised account or a serious violation, a team should first engage the committer to attempt to resolve the issue before suspending or revoking access.
+
+When a team suspends or revokes a commit bit, it should promptly inform both the committer and the core team of the reason and, for a suspension, the requirements for reinstatement.
+A committer may ask the core team to review any suspension or revocation decision.
+However, the core team generally avoids second-guessing teams that have followed these guidelines.