✍️ English & Grammar · Chapter 5

Punctuation that changes meaning

Most punctuation is taste. A small amount of it changes what a sentence instructs someone to do — and that part is worth getting exactly right.

Study this lesson free in the app →

The basics

Punctuation is the set of marks — commas, apostrophes, hyphens, colons — that tell a reader which words belong together. Most of it is taste. A small part of it changes what a sentence instructs someone to do, and that part is this lesson.

The problem it solves: "Delete the rows, which are duplicates" deletes every row. "Delete the rows which are duplicates" deletes only the duplicates. One comma, one wiped table.

The mental model: punctuation is fencing, not pausing. Forget "put a comma where you'd breathe". Ask: which words does this group belong with?

The short list worth being perfect on: its/it's, no apostrophe plurals (APIs, not API's), no splices, hyphenated compound modifiers. The one worth being careful on: the scope comma in anything someone will execute.

Explained

Delete the rows, which are duplicates. → delete all the rows; by the way, they're duplicates.

Delete the rows which are duplicates. → delete only the duplicate rows.

One comma. Two different instructions, one of which destroys data.

This lesson is only about the punctuation that does this — the marks that change meaning rather than rhythm.

The pause and the fence

People are taught that a comma is "where you pause". That's roughly true for reading aloud and useless for writing, because pauses are personal and meaning isn't.

A better model: punctuation is fencing. It says which words belong together and which are separate.

"Let's eat, grandma" and "Let's eat grandma" — the comma is a fence between the action and the person you're addressing. Remove the fence and grandma joins the menu.

So the question is never "would I pause here?" It's "which words does this group belong with?"

The comma rules that carry meaning

1. Defining vs non-defining clauses — the big one.

No comma = the clause restricts which things you mean. Comma = extra information about all of them.

The consumers that lag are restarted.      → only the lagging ones
The consumers, which lag, are restarted.   → all of them, and they lag

In a spec, a requirements doc or a ticket, this is the difference between two systems.

2. The Oxford (serial) comma — before the final "and".

We notified the leads, Priya and Sanjay.
  → did we notify 2 people (the leads = Priya & Sanjay)? or 4?
We notified the leads, Priya, and Sanjay.
  → unambiguously 3+ parties

It's optional in style terms and worth using consistently in technical writing, because lists of systems and people are exactly where the ambiguity bites. (A well-known US labour case turned on a missing serial comma in an overtime rule, and the ambiguity cost the employer a settlement — punctuation with a price tag.)

3. Comma splice — two full sentences joined by a comma.

✗ The job failed, we restarted it.
✓ The job failed. We restarted it.
✓ The job failed, so we restarted it.
✓ The job failed; we restarted it.

4. Comma before a coordinating conjunction joining two full clauses.

✓ The consumer crashed, and the lag climbed.   (two full clauses)
✓ The consumer crashed and restarted.          (one subject, no comma)

Watch one comma change a requirement

British and American style differ on that vs which, but they agree on the comma: comma = extra information, no comma = restricting the set.

Apostrophes, hyphens and the rest

Apostrophes — possession and contraction only. Never plurals.

✗ The API's are down.        ✓ The APIs are down.
✗ In the 1990's             ✓ In the 1990s
✓ The API's response time    (possession)
✓ It's failing               (it is)
✗ Its failing
✓ Its schema changed         (possessive — no apostrophe)

Its vs it's is the most-noticed error in professional writing. it's is only ever it is or it has. If you can't expand it, use its.

Hyphens in compound modifiers — genuinely change meaning:

real-time data      data that is real-time
real time data      ambiguous

a small-business owner   (owns a small business)
a small business owner   (a short person who owns a business)

re-sign the contract   (sign again)
resign the contract    (quit)

Rule: hyphenate two words acting as one adjective before a noun. Not after: the data is real time.

Semicolon — joins two complete, closely related sentences: The lag climbed; nobody was paged.

Colon — introduces a list or an explanation: Three things failed: the consumer, the alert and the runbook.

Which one deletes more data?

A ticket contains one of these two lines:

A. Delete the records, which have null customer IDs. B. Delete the records which have null customer IDs.

The table has 4 million records. About 3,000 have null customer IDs.

Where it actually shows up

Four places where punctuation stops being cosmetic:

Tickets and runbooks. "Restart the consumers, which are lagging" — all of them, or the lagging ones? The person doing it at 3 AM will pick one.

Alert descriptions. "Fires when the job fails, and the retry fails" reads as two conditions; without the comma it reads as one compound condition. Whether the alert is AND or OR matters.

Commit messages and PR titles. "Fix pipeline, add tests" is a comma splice announcing two unrelated changes — which is also a sign the PR should have been two PRs.

Anything with a list of systems. "Deployed to staging, prod and the analytics cluster" — is the analytics cluster separate from prod, or part of it? The serial comma answers it.

In each case the fix isn't better punctuation alone. It's noticing you're writing an instruction, and instructions deserve to be unambiguous even when read tired.

Comma = extra information. No comma = restricting which ones you mean.

it's only ever expands to it is / it has. Apostrophes never make plurals.

Hyphenate two words acting as one adjective before a noun: real-time data.

Words to know

In two minutes

• Punctuation fences words into groups; ask which words belong together, not where you would pause.
• No comma = defining (only these ones); comma = non-defining (all of them, plus a fact).
• The serial comma removes grouping ambiguity in lists of people and systems.
• A comma alone can't join two full sentences: use a full stop, a semicolon, or comma + and/so/but.
• Apostrophes mark possession or contraction, never plurals; it's is only ever it is / it has.
• Hyphenate two-word adjectives before a noun (real-time data), not after (the data is real time).
• For destructive or boolean instructions, don't trust punctuation: state the predicate, the expected count, and use a numbered list for AND/OR.

Test yourself

There are 11 questions, 3 puzzles and 7 recall cards for this lesson in the app — the recall cards come back on later days, just before you would forget.