# Avoid plurals in parentheses (EK00017)

import { Aside, Badge } from '@astrojs/starlight/components';

A clear plural reads better than a parenthetical suffix and avoids ambiguity about quantity in your documentation. EkLine flags parenthetical plurals such as `file(s)` and suggests rewriting them as a plural or rewording the phrase (rule EK00017).

## Why avoid parenthetical plurals in documentation?

A construction like `value(s)` forces the reader to parse two forms of the word at once and leaves the count unclear. Screen readers voice the parentheses literally, which makes the phrase harder to follow. Committing to a plural or a precise phrase removes both problems.

## What EkLine flags

EK00017 flags a parenthetical plural such as "(s)" attached to a noun.

- ❌ **Incorrect:** Select the file(s).
- ✅ **Correct:** Select one or more files.
- ❌ **Incorrect:** Enter your value(s).
- ✅ **Correct:** Enter your values.

## How to fix

Rewrite the noun as a plural, or reword the sentence to state the quantity. When the count matters, name it — for example, "one or more files."

## FAQ

### What is wrong with writing file(s)?

A construction like `file(s)` forces the reader to parse two forms at once and leaves the count unclear. Screen readers also voice the parentheses literally.

### How do you rewrite a parenthetical plural?

Use a plain plural, or state the quantity directly. "Select the file(s)" becomes "Select one or more files".

## Rule details

| Property | Value |
|----------|-------|
| Rule ID | `EK00017` |
| Category | Sentences and phrases |
| Default severity | <Badge text="Error" variant="danger" /> |
| Enabled by default | Yes |

## Ignore this rule

To keep a flagged plural on one line, add an inline comment with a reason:

```markdown
<!-- ekline-ignore-next-line EK00017 -- matches the UI label exactly -->
Select the File(s) menu item.
```

To disable the rule across your project, add it to the `ignore` list in your [configuration file](/reviewer/configuration/ignoring-rules/#ignore).

## Related rules

- [EK00004](/reviewer/rules/parentheses/) — Remove parentheses for clarity
- [EK00041](/reviewer/rules/list-punctuation/) — Require ending punctuation in list items