Example article included with the Hugo theme. Edit or replace it before publishing.
A first draft is a place to think. Editing is where you help another person follow that thinking. The challenge is making a piece clearer without sanding away everything that makes it sound like you.
Read for the idea first
Before changing individual words, read the entire piece. What is it trying to say? Where does it get distracted? Which example makes the point easiest to understand?
Move or remove paragraphs before worrying about a perfect opening sentence. A beautiful sentence cannot rescue a section that does not belong.
Make one pass for clarity
Look for sentences that ask the reader to hold several ideas at once. Split them where it helps. Replace vague references with the person, thing, or action you mean.
- Give each paragraph a clear job.
- Explain unfamiliar words when they first appear.
- Put the useful information before the explanation that supports it.
Clarity does not require every sentence to be short. It requires the relationship between your ideas to be easy to follow.
Keep the details only you would notice
A specific observation, an honest example, or a familiar turn of phrase can make a draft feel personal. Preserve those details when they help the reader understand.
Edit the friction out of a sentence, not the person who wrote it.
Read the piece aloud. If a phrase sounds unnatural when you say it, try the words you would use to explain the same idea to a colleague.
Stop when the piece does its job
Check the original promise. Does the article answer the reader’s question? Are the examples accurate? Is the next step clear?
Once those things work, another round of word swapping may not make the article more useful. Save your changes, take a break, and return with a little distance before the final review.