diff --git a/.mailmap b/.mailmap
index e0ba27dd523dd4e5ba153ac4ca0d7d2b8e12153a..b8713c1839fad85e72ffe5aaa2cad58d6a7592a2 100644
--- a/.mailmap
+++ b/.mailmap
@@ -1,3 +1,9 @@
+# This file allows re-mapping author names/emails
+# while maintaining the integrity of the repository
+#
+# Spec: https://www.kernel.org/pub/software/scm/git/docs/git-shortlog.html#_mapping_authors
+#
+
 @RubenKelevra <cyrond@gmail.com>
 Aaron Hill <aa1ronham@gmail.com>
 Adam Gashlin <agashlin@gmail.com>