Resolve Developer Aliases
=========================

The social metrics need to identify each developer that contributes
code. Unfortunately, it's common that developers have multiple Git
aliases, which will bias the social metrics.

CodeScene provides two solutions to this problem. The simplest is to
use the Developer identity mapping interface. (See :ref:`dev-alias-mapping`.)

CodeScene also supports Git mailmaps and will automatically use them
if they are present. To use mailmaps, add the ``.mailmap`` file to
the root of your repository. It specifies a mapping from multiple
aliases to one for each developer as shown in
:numref:`mailmap-sample`.

.. figure:: mailmap-sample.png
   :alt: Mailmap example
   :name: mailmap-sample

   Resolve aliases through a mailmap.

Note that mailmaps operate at a lower level, so changes in mailmaps
will not be visible in the Developer identity mapping interface.

Read the `Git Documentation on mapping
authors <https://git-scm.com/docs/git-shortlog#_mapping_authors>`_ for a
description on how to configure the ``.mailmap``.

