Refactoring English
Effective Writing for Software Developers
Many software developers think they’re naturally poor writers, but there’s no such thing.
Most software developers are weak writers because they don’t try.
You can improve your writing skills the same way you learned to become a better programmer: by learning best practices and understanding how to apply them.
Refactoring English will improve your writing in areas that matter most to developers, including:
- Emails
- Software documentation
- Blog posts
- Tutorials
I’m writing the book now, and it will be available as a digital download in 2025. Sign up below to receive updates and excerpts as soon as they’re available.
Send me updates on Refactoring English
Receive updates and sample chapters as I write the book.
Unsubscribe anytime.
Book Contents
Refactoring English teaches everything I've learned over the years about applying effective writing techniques to the domain of software.
- Why Improve Your Writing?
- Good Writing Minimizes Strain for the Reader
- Verbs Drive the Sentence
- Stay Positive: How Negative Phrasing Reduces Readability
- Passive Voice Considered Terrible
- Brevity Is Performance Optimization for Your Writing
- Hooks: Show You're Worthy of the Reader's Time
- Why So Serious? Make Your Writing Sound Natural
- Consider Your Audience
- Accommodate Skimmers
- The Writing Process
- Editing is Valuable Because it's Hard
- Manage Writer's Block
- Common Writing Pitfalls for Developers
- Improve Your Grammar Incrementally
- Work with a Professional Editor
- Work with a Professional Illustrator
- Write Better Emails
- Write Better Design Documents
- Write Better Blog Posts
- Write Better Tutorials
- Build a Personal Writing Toolset
- Continuous Improvement: Long-Term Strategies for Your Writing
Contact
Do you have questions about the book? Want to tell me about things you’re hoping to learn?
Get in touch! I’d love to hear from you.