From nobody Fri Oct 17 17:26:49 2025 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 4cpBZf32tLz6CNj2 for ; Fri, 17 Oct 2025 17:26:50 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cpBZf19vjz3SyS; Fri, 17 Oct 2025 17:26:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1760722010; 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=og2B0dTZWrBheH8ZWnL90HqVtRxWMBnbKZkBXOvSI3Q=; b=rwBAP1vDKIB8q2OqBmcRl9meiuPqRLZgQqz9yWLXSGN1fSw9N6h+Yr1Uj7GnCiLqc+aJIE CsWndcbAkub/kB1meSBF+E4haizWG1knUYPtY5PoS3jcRhAWvXelB0q8Kr5gT7rIhuJ+F3 HD+eQNO+7nDtnf866swhjnmbBfMDOZO1Eza6q8VZEvGwtLJwypA2BGooCo2rkPTauUr9rT RuJ7OGU20YDJtq1t8GUELH4bqhUtbosmHLz1ramKlB+AlEuKqEUVgoT+yr+Qr+KyDq3UaY id+AVK0rzbFK+G6HzvFRL3GD7qqpndf3aEfLIo9KC6sA4sy3qOgBjm3xLa9ziw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1760722010; 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=og2B0dTZWrBheH8ZWnL90HqVtRxWMBnbKZkBXOvSI3Q=; b=cvY1RrFKqmeVEOe8N38/wQbmId2QDVn8yGUiHOVDxxai37LMgDxUIexioXmMZhOCPbmen7 GoXcsXXDTUUAlc5m+RgjVpg+ZosdNXi/TskFGcO7Tl61G0hiM4LpvYQ9LSooPGFioZoz6l 1v+vJBiDU3WxOD2wHNrY2OTItJtWRK2odOXnBE0A2pN2F63LmuI3yp2GTxJzkF2NMIOMzu IEAnP4T/UOthJLA6pR8cD3g3TU1aYs5s+ZwafwO1Ej5aOb/mEj3Li9kBlAQlNsZdy23M4f L7d7W7Bs1dsMTj1z5MvRzraT3niGk5O9NZFIoPn0zRkIe9W45IFF7P86RwxSgw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1760722010; a=rsa-sha256; cv=none; b=d9i1h6Vrsjh33m+uHpZmQ5zlO69LVDCzfUgaHS8IbeelelgG2rUxM3dCNxoLtbbnsCvCsC lItedWCxarT97ozEqaLSZeX+hatJFFE2nw+W3KRTg8nqvGw56qOhml1oGbM3lK0a90tkU2 1W1Fzae3J5GKO6jod4qIzLzTzMZT5u8KYFi5if8rVKUKHzIQPpGi0AKx9gSpQ0VLKiD1rD 7nyNplH3nlOU7XHxDWniu3lJ9bDGirOJBFdsNYYxxXeeCTJczJ3tVPmqyTe4y/f4STYayK OBafI+kybSWHbUNcBIOSXFReLTC5XcAKfVu8ALJA+72PBidDxk3pm7QTqYAfeQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cpBZf0RfPz1443; Fri, 17 Oct 2025 17:26:50 +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 59HHQoSs029171; Fri, 17 Oct 2025 17:26:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 59HHQnBa029168; Fri, 17 Oct 2025 17:26:49 GMT (envelope-from git) Date: Fri, 17 Oct 2025 17:26:49 GMT Message-Id: <202510171726.59HHQnBa029168@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: e84cab12c0 - main - new-committers: add mailmap advice 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: e84cab12c0c44af6840c5abc4de85cec684c88bc Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=e84cab12c0c44af6840c5abc4de85cec684c88bc commit e84cab12c0c44af6840c5abc4de85cec684c88bc Author: Warner Losh AuthorDate: 2025-10-17 17:23:49 +0000 Commit: Warner Losh CommitDate: 2025-10-17 17:26:55 +0000 new-committers: add mailmap advice Since we've started bringing in people via github, etc, they have a number of commits with a different author than the FreeBSD address. Suggest that people add their new FreeBSD address. Suggested by: srcmgr call Sponsored by: Netflix --- documentation/content/en/articles/committers-guide/_index.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 07cece334d..7c26bd1f27 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2199,6 +2199,12 @@ It is very important to have a current PGP/GnuPG key in the repository. The key [.filename]#src/share/misc/committers-.dot# - Add an entry to the current committers section, where _repository_ is `doc`, `ports`, or `src`, depending on the commit privileges granted. + Add an entry for each additional mentor/mentee relationship in the bottom section. +. Update git mailmap file ++ +[.filename]#src/.mailmap#, [.filename]#doc/.mailmap#, and [.filename]#ports/.mailmap# - Add an entry for commits you created prior to becoming a FreeBSD committer. ++ +Mapping to your FreeBSD address allows us to track external committers who may be ready for a commit bit more easily. +You can also use this to correct old names, mispelled names, etc in the default `git log` output. . Generate a Kerberos Password + See crossref:committers-guide[kerberos-ldap, Kerberos and LDAP web Password for FreeBSD Cluster] to generate or set a Kerberos account for use with other FreeBSD services like the link:https://bugs.freebsd.org/bugzilla/[bug-tracking database] (you get a bug-tracking account as part of that step).