Z512: EMPTY_SECTION
Severity: warning
Penalty: 1.0 point
Category: content
Auto-fixable: No
Description¶
A heading section contains zero body content before the next heading or the end of the file.
Empty sections act as visual placeholders that confuse readers and indicate incomplete or abandoned documentation sections.
How to Fix¶
- Add explanatory text, code snippets, or list items beneath the heading.
- Remove the empty heading if the section is not needed.
Suppression¶
If a heading is intentionally empty, add an inline comment directive below or above the heading:
Reference¶
See the Finding Codes Index for finding code details.