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 @@ -1,43 +1,44 @@ --- title: "Policies for FreeBSD Project Members" sidenav: docs --- include::shared/en/urls.adoc[] = Policies for FreeBSD Project Members == *Committer's Guide* The link:{committers-guide}[Committer's Guide] is an overall guide for all new committers, including both technical details and policy details. For the latter, see the chapters on link:{committers-guide}#conventions[Conventions and Traditions], link:{committers-guide}#developer.relations[Developer Relations], and link:{committers-guide}#rules[The FreeBSD Committers' Big List Of Rules]. It contains almost everything a new committer to the FreeBSD Project needs to know. See the Documentation Project Primer and the Ports Guide, below, for more info. == *General Policies* * link:../code-of-conduct[Code of Conduct] * link:../resources[Commit Bit and Project Resources Policy] * link:../expire-bits[Commit Bit Expiration Policy] * link:../bylaws[Core Bylaws] * link:../core-vote[Core's Voting Procedures] * link:../hats[Hats Term Limits Policy] * link:../i18n[Internationalization Policy] * link:../new-account[New Account Creation Procedure] * link:{pr-guidelines}[Problem Report Handling Guidelines] * 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* The link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors] covers everything you will need to know in order to start contributing to the FreeBSD Documentation Project, from the tools and software you will be using (both mandatory and recommended) to the philosophy behind the Documentation Project. The link:../doceng[FreeBSD Doceng Team Charter] describes the purpose of Doceng. == *The FreeBSD Ports Guidelines* The link:{porters-handbook}[FreeBSD Porter's Handbook] is a general guide for FreeBSD ports committers, including both technical information and policy guidelines. The link:../../portmgr/[Ports Management Team] has a separate page with policies and other information related to the FreeBSD Ports Collection. link:..[FreeBSD Internal Home]