---
name: wrong-kind-of-comment
description: Flag comments that describe *what* the code does instead of *why* it does it.
license: Apache-2.0
metadata:
  copyright: The Kubernetes Authors
---

# Skill: Wrong Kind of Comment

**Wrong kind of comment** — comments that describe *what* the code does instead of
*why* it does it. Useful comments explain non-obvious motivation, hidden constraints,
or the theoretical background a reader could not infer from the code itself.
