Poorly documented large function¶
ID: cpp/poorly-documented-function Kind: problem Severity: warning Precision: medium Tags: - maintainability - documentation - statistical - non-attributable Query suites: - cpp-security-and-quality.qls
This rule finds large functions that have too few comment lines. Documentation becomes more important as a function becomes more complex, and a lack of documentation makes it harder to maintain.
Add comments to document the purpose of the function. Large, complex functions in particular require detailed documentation, not only because they are harder to understand, but the process of documentation may reveal that the function could be split into smaller, more cohesive functions.