Severity Conversions
========================
As of DBOARD3-1256 the alarm severities will no longer be named the same between
Argus and dashboard-v3 and so severities will need to be converted whenever communication between
Argus and dashboard-v3 services occurs.

This is done to minimize the changes needed in dashboard-v3 to support the new severities,
only necessitating the addition of a new critical severity without changing the existing ones.
Therefore severities are converted only when communicating with Argus and left as is as much
as possible within dashboard-v3 code to avoid confusion.

Currently there are only two places where these severity conversions happen. Firstly when
blacklists are received by Correlator from Argus, and secondly in argus notifier when
serializing alarm information for sending to Argus.

This table shows how severities will be represented in dashboard-v3, Argus, and
how they relate to each other:

.. image:: ../images/severity-table.png