# Prefer simple, concise words (EK00038)

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

Simple words reach a wider audience and read faster than complex vocabulary, without losing meaning, so choose the plainer synonym. EkLine flags a complex word that has a simpler equivalent and suggests the plainer choice (rule EK00038).

## Why prefer simple words in documentation?

Complex vocabulary slows readers and raises the barrier for anyone reading in a second language. A word like `accomplish` rarely says more than `do`, yet it costs the reader more effort. Choosing the simpler synonym keeps your documentation clear and inclusive.

## What EkLine flags

EK00038 flags a complex word that has a shorter, simpler equivalent.

- ❌ **Incorrect:** This accelerates the build.
- ✅ **Correct:** This speeds up the build.
- ❌ **Incorrect:** You can accomplish this with one command.
- ✅ **Correct:** You can do this with one command.
- ❌ **Incorrect:** approximately 10 files
- ✅ **Correct:** about 10 files

## How to fix

Replace the flagged word with the simpler synonym EkLine suggests. Keep the complex word only when it carries a precise technical meaning the simpler word loses.

## FAQ

### Why do simple words improve documentation?

Simple words lower the barrier for readers, especially anyone reading in a second language, and they read faster. A word like "accomplish" rarely says more than "do".

### When should you keep a complex word?

Keep the complex word when it carries a precise technical meaning that the simpler synonym would lose. Everywhere else, the plainer choice is clearer.

## Rule details

| Property | Value |
|----------|-------|
| Rule ID | `EK00038` |
| Category | Sentences and phrases |
| Default severity | <Badge text="Suggestion" variant="note" /> |
| Enabled by default | No |

## Ignore this rule

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

```markdown
<!-- ekline-ignore-next-line EK00038 -- precise technical term -->
The scheduler accomplishes the rollout in three ordered phases.
```

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

## Related rules

- [EK00042](/reviewer/rules/ek00042/) — Prefer concise words over complex terms
- [EK00006](/reviewer/rules/ek00006/) — Remove unnecessary adverbs