# Use semicolons judiciously (EK00036)

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

Short, separate sentences read more clearly than two clauses joined by a semicolon, so break the clause in two. EkLine flags a semicolon that joins independent clauses and suggests splitting the sentence (rule EK00036).

## Why split semicolons into separate sentences?

Semicolons join two ideas that often read better as standalone sentences, especially in instructions your audience skims. Splitting them shortens each thought and makes procedures easier to follow. Shorter sentences also translate more cleanly and reduce the chance a reader loses the thread mid-clause.

## What EkLine flags

EK00036 matches a semicolon that joins two independent clauses in a sentence.

- ❌ **Incorrect:** The build failed; check the logs for the cause.
- ✅ **Correct:** The build failed. Check the logs for the cause.
- ❌ **Incorrect:** Save your changes; then restart the service.
- ✅ **Correct:** Save your changes. Then restart the service.

## How to fix

Replace the semicolon with a period and start a new sentence.

<Aside type="tip">
A semicolon is the right choice when it separates items in a list that already contain commas. In that case, keep the semicolon and ignore the rule for that line.
</Aside>

## FAQ

### When is a semicolon acceptable?

A semicolon is the right choice when it separates list items that already contain commas, such as "Dublin, Ireland; Paris, France; and Tokyo, Japan." Keep it in that case.

### How do you fix a semicolon that joins two sentences?

Replace the semicolon with a period and start a new sentence. For example, "The build failed; check the logs" becomes "The build failed. Check the logs."

## Rule details

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

## Ignore this rule

To keep a semicolon on one line, add an inline comment:

```markdown
<!-- ekline-ignore-next-line EK00036 -- semicolons separate list items with commas -->
The regions are Dublin, Ireland; Paris, France; and Tokyo, Japan.
```

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

## Related rules

- [EK00021](/reviewer/rules/ek00021/) — Limit sentences to 32 words or fewer
- [EK00038](/reviewer/rules/ek00038/) — Prefer simple, concise words