Re: [PATCH] doc: document the current project governance

From: Junio C Hamano <gitster@pobox.com>
Date: Nov 2, 2026, 22:57 UTC
Message-ID: <xmqqmrrqg7uf.fsf@gitster.g>
In-Reply-To: <pull.2479.git.git.1793632435937.gitgitgadget@gmail.com>

"Antonin Delpeuch via GitGitGadget" <gitgitgadget@gmail.com> writes:

> += Governance of the Git project

> +This document describes the social structures in place in the Git project. It intends to be neither prescriptive, nor express a judgment on the merit of those existing ways of working.

Can you line-wrap these? Even though once .adoc is rendered into .html or whatever presentation format, how the source document had its words in it would not be visible, but a single long line that has an entire paragraph is very hard to work with when we are discussing the document in its source form.

Show 7 quoted lines

> +The Git project develops a free and open source distributed version
> +control system.  The scope of the project covers
> +https://git-scm.com/install/source[the git.git repository],
> +associated repositories hosted under the https://github.com/git[git
> +GitHub organization] and the <git@vger.kernel.org> mailing list.
> +Other spaces are considered external to the Git project for the
> +purposes of this document.

Do we want to also cover Discord and IRC chat channels? (cf. https://git-scm.com/community)

Show 5 quoted lines

> +[NOTE]
> +====
> +Not knowing exactly what is considered part of the Git project or a third-party project, I have left the following repositories and initiatives out of the scope of this document for now, but I am not sure about this choice:
> +
> +* https://github.com/git-for-windows/git[Git for Windows]

What do they call themselves? A friendly fork? https://gitforwindows.org/ might be a more official entry into their universe. I dunno.

> +=== Project Leadership Committee
> +
> +The Project Leadership Committee (PLC) liaises between the project
> +and the Software Freedom Conservancy, Git's fiscal sponsor.

We are a "member project" of SFC, which acts as our "fiscal sponsor" for us, providing non-profit administrative, financial and legal infrastructure.

Show 9 quoted lines

> +Those members are renewed by cooptation, after consultation with the
> +community. When doing so, the over-representation of an employer in
> +the PLC is
> +avoided.footnote:[https://lore.kernel.org/git/20180821020849.GA2527@sigill.intra.peff.net/[Re:
> +Git Project Leadership Committee], Jeff King, 20 Aug 2018]
> +
> +NOTE: Is there any existing process for leaving the PLC? (for
> +instance, if someone has become inactive in the project or is in
> +conflict with the rest of the project's leadership)

Nothing that I know of.

Show 6 quoted lines

> +=== Security team
> +
> +The security team triages vulnerability reports sent to the project.
> +They do so on the private mailing list <git-security@googlegroups.com>.
> +This team also includes people operating widely used git hosting sites and packagers.footnote:[https://lore.kernel.org/git/xmqqbj9d3y9x.fsf@gitster.g/[A note from the maintainer], Junio C Hamano, 1 Oct 2026]
> +

> +Is the list of subscribers to git-security public?

NTK as far as I know.

> +How does one gain and lose access to this list?

By asking for an invitation.

Show 5 quoted lines

> +Does Johannnes Schindelin play a particular role in the security
> +team?
> +https://lore.kernel.org/git/5cc325c6-579e-4fed-7071-a3ff98d51ccb@gmx.de/[He
> +seems to have the lead in triaging vulnerability reports], but I
> +can't really tell to what extent

Why don't you ask him yourself by CC'ing this patch ;-)

Show 5 quoted lines

> +=== Localization maintainer
> +
> +Jiang Xin coordinates the localization of Git by maintaining https://github.com/git-l10n/git-po[git-po].
> +
> +NOTE: How would their successor be appointed?

Not limited to this, but there is in general no "appointing" process. If there becomes an open seat that needs to be filled, it will stay vacant until somebody volunteers.