---
url: https://scruple.dev/rules/comments/no-useless-comments.md
description: Disallow comments with no maintenance value.
---

# comments/no-useless-comments

Disallow comments with no maintenance value.

## What it checks

Ordinary comments should add context instead of restating straightforward code, adding generic headings, or narrating obvious actions.

## Rule metadata

* Package: `@scruple/comments`
* Category: Comment quality
* Tags: noise, maintenance, restatement
* Default threshold: `0.9`
* Minimum confidence: `0.7`

## Examples

### Reported

```ts
// Increment count.
count += 1;
```

### Accepted

```ts
// Include the current attempt in the rate-limit window.
count += 1;
```