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:
- Design documents
- Tutorials
- Blog posts
- Emails
The book is now available in early access.
Book Contents
Refactoring English teaches everything I’ve learned over the years about applying effective writing techniques to the domain of software.
- Preface: Why Improve Your Writing?
- Part One: Writing Techniques
- Get to the Point
- Make Your Writing Sound Natural
- Help the Reader Reach Their Goal
- Meet the Reader Where They Are
- Verbs Drive the Sentence
- Stay Positive: How Negative Phrasing Reduces Readability
- Passive Voice Considered Harmful
- Respect the Reader’s Mental Bandwidth
- Delete Aggressively
- Eliminate Ambiguity
- Improve Your Writing with AI
- Overcome Writer’s Block
- Stay in Flow State
- Improve Your Grammar Incrementally
- Part Two: Document-Specific Guides
Supporters
Thanks so much to readers who financially supported the book early on!
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.