From nobody Sun Dec 01 18:00:57 2024 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 4Y1ZTj5Xs9z5fySv for ; Sun, 01 Dec 2024 18:00:57 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Y1ZTj54jGz42kC; Sun, 1 Dec 2024 18:00:57 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1733076057; 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=zKBD1JR9H1xchTtIHppFcLDiW/lXQbfk0NMsXDmk3aU=; b=BKlrbal5UAozmNahQmO64pKeJ26RoUA+brMSEeu/hUElQ8/m9qah4xfM88jCg9mCvdaZR0 grkkL5tNdSuL4js5LA33afp6HZAD58B/3oScBy36+j0pa3DVhN7SshOUmHnBhiHuTpVjcS tJ+nqIn3l33b1YgO2nOdUi0UGR9c0/0yJ68beJnLXmfvMkPfobUvyu/4GOIevBmFhiWceJ 6A/jrj+9uft3FPyEr/iGwKUTIP+EHMhdPitelko3u0v9ccsSBgJ50hJ0vNC0Jjvm7iRQy4 yJ2SsCH1SwcRzI7qQsO59SGx1Yv1CM7ksklgG29Iet4Rlx+uXcFCcGqN7KGQDQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1733076057; 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=zKBD1JR9H1xchTtIHppFcLDiW/lXQbfk0NMsXDmk3aU=; b=shefR+vAJIM9n1qeigpHsr+AD1b5c/+hC0jJRSr1EQ9NfFKWNKwbCFDBJSOyJExNj7hqRW f6pebhCP59fgjsqtCi9R4og4v6Xs/r+cPwW1mNet5MzGv0iEM3USOrafxGLZSNCs4R3H/S 6GNHZeCQXHAL2JBFHRcOau6Bnl7KqfpjeUAv+ld+xnKKENZoYk6Chv5iw7GG/aYj+a+GTU vvlEicMVqyEyETYU8Qu6Lbhz8dDlAvpDyerrnr2sfTYL43XLSOlfASCbgg/5HjeS7v4/NJ yjeARppdgSErQicwlCjUmw2gzGsa0E0rfiAbNhAJQPFnxZnWQ1TFfURV+KlTlQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1733076057; a=rsa-sha256; cv=none; b=JiA76mu5bhfr8e4U4O2qDvMIEfdcCouee9M82bVbphhKP6TVHdVsAGgSVgogMQ15sp6+Vg vkwzhiOBH7LV93Wgs8XuF4ZC8kzysTZw9VkunywCqhSbvqJfFTVjBiFdNf9Kfwf2Zhwfe0 fVTWl9TuPzjCni+Y+Sc7Uaj9paNyjkGS44Adin2KssePW84OvKd5yCVbEQgObYb5SQ7pcY 6dA9GE1zGtUg5Z9oPn15XpbC4qPctZFnia/1HWjupgd/ZeGl3a+kBZSyFl2/rQ1UvEkjWj twivI0Yo699hV9f+20cjH0AjBpATa6N6mcgKfkit+4HpocsKwSBE05f23xrelQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Y1ZTj4MSgz13cL; Sun, 1 Dec 2024 18:00:57 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4B1I0vFi065775; Sun, 1 Dec 2024 18:00:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4B1I0vl6065772; Sun, 1 Dec 2024 18:00:57 GMT (envelope-from git) Date: Sun, 1 Dec 2024 18:00:57 GMT Message-Id: <202412011800.4B1I0vl6065772@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: 7534198777 - main - Add srcmgr charter, as approved by core. 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 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: 75341987779d4071c013901824f4a57d1734cb49 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=75341987779d4071c013901824f4a57d1734cb49 commit 75341987779d4071c013901824f4a57d1734cb49 Author: Warner Losh AuthorDate: 2024-12-01 18:01:21 +0000 Commit: Warner Losh CommitDate: 2024-12-01 18:01:21 +0000 Add srcmgr charter, as approved by core. Sponsored by: Netflix Reviewed by: emaste Differential Revision: https://reviews.freebsd.org/D47573 --- website/content/en/srcmgr/charter.adoc | 51 ++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/website/content/en/srcmgr/charter.adoc b/website/content/en/srcmgr/charter.adoc new file mode 100644 index 0000000000..2605480850 --- /dev/null +++ b/website/content/en/srcmgr/charter.adoc @@ -0,0 +1,51 @@ +--- +title: "Charter for the Source Management Team" +sidenav: about +--- + += Charter for the Source Management Team + +The Source Manager Team (srcmgr) is a group of FreeBSD developers charged with overseeing the development of the FreeBSD base system source tree and products generated from the source tree. +The goal of this team is providing base system artifacts and releases that are functional, stable, and performant. +The base system is built from the src git repository and includes the kernel, boot loader, and userland. + +== Responsibilities + +To support this goal, the srcmgr team has the following responsibilities (_Inline notes in italics are descriptive but not binding_): + +* Approve new and returning commit bits for the source repositories. +* Reclaim idle commit bits for the source repositories. +* Define and manage recruiting activities for both new committers and mentors. + _This includes identifing active contributors who are not yet committers and soliciting mentors for new contributors from existing committers. We can manage any subcomittee that does the recruiting._ +* Arbitrate disputes related to the source repository between FreeBSD community members. +* Define and encourage healthy norms for interactions between committers and external contributors. + _For example, guidelines and best practices for reviewing patches and working with bugmeister@ to develop source-specific bug triage workflows._ +* Define the policies for committing changes to the source repository + _For example, who can merge commits to the repository and when. This includes explicit authority to revert commits and to enforce freezes, etc. Another example is to define how to maintain policies. This policy will vary by branch._ +* Ensure base system artifacts are produced and published. + _For example, working with re@ to validate release images or ensuring base system packages are published on a timely basis._ +* Defining expectations for src commits. + _For example, which toolchains are supported, required. Are cross-builds from other platforms required or not. Which tasks are checked in post-commit CI. Which breakages are acceptable after commit vs highly discouraged._ +* Communicating summaries of activities in line with project norms. + _For example, publishing monthly or quarterly reports, having open meetings or discussion forums where decisions are made in the open, etc. The exact form of these things evolve over time, so the specific requirements are not spelled out in the charter._ +* Work with other parts of the project and the Core Team when coordination is necessary. +* srcmgr MUST maintain clear written policies for each of the chartered responsibilities. + +Please see link:../policies/[Source Team Policies] for a complete list of the current policies which have been adopted to help implement these goals. + +== Membership + +Voting members shall serve terms of one year. +An individual member may serve up to three consecutive terms. +A member will be eligible for an additional three terms after a break of at least one full term (one year). +The team should also include one or more non-voting members ("lurkers") as candidates for future voting members. +Voting members and lurkers shall be chosen by existing voting members of the srcmgr team. +srcmgr must publish changes to its voting and non-voting membership. + +The initial team shall be selected by the Core Team. At its discretion, the Core Team may alter the membership. + +== Authority + +The srcmgr team operates under the authority of the FreeBSD Core Team. +This charter is valid until such time as it is modified or revoked by the Core Team; any changes to this charter must be approved by the Core Team. +The Core Team will oversee srcmgr and arbitrate disputes involving it as necessary.