update docs for severity options