Refactoring English - Effective Writing for Software Developers is an upcoming book by Michael Lynch.
His sample chapter Rules for Writing Software Tutorials was a really good one and the table of contents seems very interesting:
Grab the Reader’s Attention Immediately
Why Improve Your Writing?
Write Better Tutorials
Write Better Emails
Write Better Design Documents
Write Better Blog Posts
Good Writing Minimizes Strain for the Reader
Verbs Drive the Sentence
Stay Positive: How Negative Phrasing Reduces Readability
Passive Voice Considered Harmful
Brevity Is Performance Optimization for Your Writing
Why So Serious? Make Your Writing Sound Natural
Expand 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
Using AI Tools
Build a Personal Writing Toolset
Continuous Improvement: Long-Term Strategies