From 4befe4fc30e7d6388eef261f672b6fc18e8d389e Mon Sep 17 00:00:00 2001 From: Greg Price Date: Wed, 23 Mar 2022 14:11:01 -0700 Subject: [PATCH] mailmap: Add a comment explaining this file. In particular, link to upstream documentation. This should help contributors be able to see what it's doing and how to update it. Copied straight from what we have in the zulip-mobile repo. --- .mailmap | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/.mailmap b/.mailmap index 41514e850a..8e170d7498 100644 --- a/.mailmap +++ b/.mailmap @@ -1,3 +1,17 @@ +# This file teaches `git log` and friends the canonical names +# and email addresses to use for our contributors. +# +# For details on the format, see: +# https://git.github.io/htmldocs/gitmailmap.html +# +# Handy commands for examining or adding to this file: +# +# # shows all names/emails after mapping, sorted: +# $ git shortlog -es | sort -k2 +# +# # shows raw names/emails, filtered by mapped name: +# $ git log --format='%an %ae' --author=$NAME | uniq -c + Alex Vandiver Alex Vandiver Allen Rabinovich