Ensure code coverage exclusions are justified

Docs > Code Analysis > Static Analysis Rules > Ensure code coverage exclusions are justified

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

Metadata

ID: csharp-best-practices/coverage-justification

Language: C#

Severity: Warning

Category: Best Practices

Description

When using ExcludeFromCodeCoverage, always provide a reason for the exclusion. This helps with code maintenance and is part of the documentation that helps other engineers understand why the code is excluded from coverage.

Non-Compliant Code Examples

class MyClass {
    [ExcludeFromCodeCoverage]
    public void MyMethod()
    {
    }
}

Compliant Code Examples

class MyClass {
    [ExcludeFromCodeCoverage(Justification = "Code used by some flaky test that will be removed soon")]
    public void MyMethod()
    {
    }
}