Skip to content
Sarj Sarj Sarj Standards

no-comment-cruft

Commented-out code, mechanical narration, decorative banner, or untracked work marker.

SARJ016 Rule source Tests Catalog JSON

Why

Mechanical narration and dead code obscure the constraints and rationale that comments should preserve.

Fix

Delete the cruft. If author-controlled code is unclear without narration, clarify names, types, or structure; keep only concise comments for a hidden reason or constraint.

Examples

Before — flagged Dead code preserved as a comment
service.py
value = load()
# return value
save(value)
After — preferred Comment records an external constraint
service.py
value = load()
# Keep this ordering because Clerk caches the first lookup.
save(value)