Document reasoning behind ignoring certain warnings

[nickerso]

We need to document (or add to existing documentation) to provide the reasoning for why we enable/disable specific compiler warnings, as well as coverage and formatting checks. This will help support and improve the review, for example, of #761.