From nobody Fri Jun 26 17:14:11 2026 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gn2Mm0CNkz6jp6Q for ; Fri, 26 Jun 2026 17:14:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gn2Ml6cX6z4P2n for ; Fri, 26 Jun 2026 17:14:11 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782494051; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=OyzjfdxGaz3CCHU++aqwnhmY6hmQQtC8+HLYmwhkdHg=; b=M5qGHBNXTSUEzqqXpgFVGfo4Yt4NFniZa+imoHwCP5SKJokjfq5d7nTtAIsvMaOijL9I9M 56k62eNqqa92lcWCFZAheJZ4fx97t5ZGjFTY+hfBLxEhgcgEuQTH8T9CI3O/Fo2zBzaVLR jmquHmTfK2OQlTptdmC7+mV8XpTT+370vFBJ1U9XmNRdOZVbBq2/SWdeup4OPjeBQ7VM9K iet6qYzIe12BQsEtFh3ctpNtyRuvsKWZxCDAkP1f3qouALf+MMToxJ1rPUjabtDTQOoctK 3i+zesZ+ihog+KXchCSGwRj0Rf3hb5ydm2d8opMkksueeP1Z/cqOkvt5xglNww== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1782494051; a=rsa-sha256; cv=none; b=aqDC1zu8z8KkTrhwYyoLg5xd9I9lXA+CijpVVROJUbXKPfnOqsYQBi96pfgWMU+bf6z0KF Jbj9YpOpv/IblZRnbCPapApu/1BCv3HSm5n1YehYrc1rtR/AFIOTqj9ktUqL2qgrprdkNF ijW8zJsQWmZYwt2f5frkMcY23ZCShf03X1WyaDhKtZfXb2+qcRyYCG2EE4oby68BMmrhBR 0Uc3rRe1MAwIhyDK8y4DUIR61PCNcV5yHz2K+XOizVeCsZLk4HS42SL/W9vpzpXWvAQjJ8 xHwU5sWj904e5LgVsg7kpXUyjk0xyc12CfwE90EGyiqKpglKLgN7yioMo7gMMw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1782494051; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=OyzjfdxGaz3CCHU++aqwnhmY6hmQQtC8+HLYmwhkdHg=; b=clSqezaUNV7SnSZr+XlC1c1YDcu5ce5dGePsCzB0kk29KkAPsKdkBcKyZcemnAF1AbCMWT rcFclo1mh7jwWzl4vX/jd68pomdW9aeJ9p81j/aeflqegEtLDxnlcFvz5zKnWD/MoyOcCK GYdjd30SmklsV/KvBQz8hHc8Iyx6rKZqzHYD74+smYaz3lbllzyiyThtZXJDfR5Xym3U6o 63QrOkxsD/YebcA8bUl7XOpRbkOAHrjIV3ZDDMSsv87ouCzXHnV0JsuB4saULzAe9quc2P eYXdmU0OleNzONZ5nTSF6oOQ6OwnCPQXtZiPQ4efl3KvNVmwZNpF7tm7ACFO6w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gn2Ml5LkzzmpQ for ; Fri, 26 Jun 2026 17:14:11 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 381b6 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 26 Jun 2026 17:14:11 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: 072353ccfc - main - policy: Cross Repo Commit Policy List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 072353ccfc5ddb7e794d7633d44a585b32e4e175 Auto-Submitted: auto-generated Date: Fri, 26 Jun 2026 17:14:11 +0000 Message-Id: <6a3eb363.381b6.6b0f67a9@gitrepo.freebsd.org> The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=072353ccfc5ddb7e794d7633d44a585b32e4e175 commit 072353ccfc5ddb7e794d7633d44a585b32e4e175 Author: Warner Losh AuthorDate: 2026-06-26 14:59:45 +0000 Commit: Warner Losh CommitDate: 2026-06-26 15:00:42 +0000 policy: Cross Repo Commit Policy Add Cross Repo Commit policy that was originally discussed in January 2023 by core, and ratified by the current core team on XXXX. Sponsored by: Netflix Reviewed by: ziaee, 0mp, kevans, glebius, adrian Approved by: core (24-hour rule) Differential Revision: https://reviews.freebsd.org/D57514 --- website/content/en/internal/cross-repo-commits.adoc | 21 +++++++++++++++++++++ website/content/en/internal/policies.adoc | 1 + 2 files changed, 22 insertions(+) diff --git a/website/content/en/internal/cross-repo-commits.adoc b/website/content/en/internal/cross-repo-commits.adoc new file mode 100644 index 0000000000..bb8019479e --- /dev/null +++ b/website/content/en/internal/cross-repo-commits.adoc @@ -0,0 +1,21 @@ +--- +title: "Cross Repo Commit Policy" +sidenav: docs +--- + += Cross Repo Commit Policy + +This policy provides flexibility for contributors to commit across repositories without heavyweight processes for small, low-impact changes, while ensuring larger changes still undergo normal review and oversight. + +== Policy Guidelines + +* *Obvious Fixes:* Anyone may make obvious, small changes (e.g., typo or build break fixes) to any repository, subject to repository-specific rules. +* *Repository Rules:* Committers must know, understand, and follow the specific rules and validation tools of the repositories they are modifying. +* *Cross-Repository Trust:* When committing outside their primary area, committers are trusted to use their best judgment based on the following framework: +** *Sufficient Review:* The change has received appropriate peer review for its size and complexity. +** *Expert Consultation:* Repository experts are consulted for non-trivial changes. +** *Stricter Rules:* The committer remains deferential to areas requiring formal oversight (e.g., the `ports/Mk` tree). +** *Scale:* The larger or more complex the change, the more critical it is to seek review and wait for explicit approval. +* *Accountability:* Committers must accept feedback on both process and content. If a mistake occurs, the default action is an immediate backout, followed by a more formal review, as appropriate. + +When in doubt, ask first and seek a sanity check. diff --git a/website/content/en/internal/policies.adoc b/website/content/en/internal/policies.adoc index 0012cb0a99..88a4a8f7db 100644 --- a/website/content/en/internal/policies.adoc +++ b/website/content/en/internal/policies.adoc @@ -27,6 +27,7 @@ It contains almost everything a new committer to the FreeBSD Project needs to kn * link:../software-license[Software License Policy] * link:../data[User Data Policy] * link:../members[FreeBSD Project Membership] +* link:../cross-repo-commits[Cross Repo Committing Policy] == *The FreeBSD Documentation Project*