Tech writing for developers: Docs, READMEs, and ADRs that persuade

This book is a practical, no-fluff guide to creating clear, confident, and persuasive documentation—from READMEs that get projects adopted, to docs that reduce support tickets, to Architecture Decision Records (ADRs) that align teams and end endless debates.Written specifically for developers, it bridges the gap between technical accuracy and human understanding. You’ll learn how to explain complex systems without dumbing them down, justify decisions without sounding defensive, and write docs that scale with your codebase.Inside, you’ll discover:How to write READMEs that onboard users and contributors in minutes—not hoursDocumentation structures that make information easy to find and hard to misunderstandADRs that persuade stakeholders and preserve context for future teamsWriting techniques that turn “just documentation” into a strategic engineering assetReal-world examples, templates, and checklists you can use immediatelyWhether you’re an individual contributor, tech lead, or architect, this book will help you communicate your ideas with clarity, credibility, and impact—and make your work matter long after the code is written. Read more