git: e84cab12c0 - main - new-committers: add mailmap advice

Warner Losh <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/doc/commit/?id=e84cab12c0c44af6840c5abc4de85cec684c88bc

commit e84cab12c0c44af6840c5abc4de85cec684c88bc
Author:     Warner Losh <[email protected]>
AuthorDate: 2025-10-17 17:23:49 +0000
Commit:     Warner Losh <[email protected]>
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-<repository>.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).
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.