Refactoring - A Developer's Guide to Writing Well

Discover practical techniques for improving your writing skills as a developer in this 37-minute conference talk. Learn how to transform unhelpful pull request write-ups into clear, informative documents that inspire and educate your teammates. Explore advice from fiction authors, book editors, and technical writers to enhance your ability to communicate effectively in various aspects of development work, including commit messages, code reviews, and architecture documentation. Gain insights on overcoming common writing challenges, such as decluttering your text, avoiding ambiguity, and improving flow. By the end of this talk, you'll be equipped with valuable strategies to elevate your writing and become a more effective communicator in your development team.

Intro
Do you write well
Pull Requests
Writing at Work
You Know Too Much
Get Ready to Edit
Declutter
Garden paths
Flow
Medium