Writing for Developer

Pragmatic methods for writing blogs, articles, and other technical pieces that stand out from the crowd!

Do you want to connect with your community, share your state-of-the-art achievements, and help your peers benefit from your hard-fought lessons learned? Do you want to get the kind of attention that expands your career? Master the art of writing engineering blog posts and articles! This comprehensive guide shows you how to create content your fellow developers will love to read and share.

Writing for Developers is full of the practical tips, tricks, and techniques you need to translate the ideas floating around your head into content that’s clear and compelling, including how to:

• Pinpoint topics that make intriguing posts
• Apply popular blog post design patterns
• Rapidly plan, draft, and optimize blog posts
• Make your content clearer and more convincing to technical readers
• Tap AI for revision while avoiding misuses and abuses
• Increase the impact of all your technical communications

Whether you’re brand new to writing, or a seasoned hand who wants more attention for your work, Writing for Developers will help ensure your writing resonates with readers. This isn’t a generic writing guide—from start to finish, the book is laser-focused on technical topics, writers, and audiences. Authors Piotr Sarna and Cynthia Dunlop combine their differing perspectives as an engineer and professional writer to help you write compelling works. You’ll learn through detailed examples, methodical strategies, and a “punk rock DIY attitude!”

Foreword by Bryan Cantrill. Afterword by Scott Hanselman.

Purchase of the print book includes a free eBook in PDF and ePub formats from Manning Publications.

About the technology

A well-crafted technical article can spark a new idea, demystify a technology, expand your perspective, or save you from going down a disastrous path. Even if you don’t consider yourself a “good writer,” you can make a difference by sharing insights and advancing the community. This practical guide shows you how to create blogs, articles, and other content your fellow developers will want to read and share.

About the book

Writing for Developers introduces seven popular patterns for modern engineering blogs—such as “The Bug Hunt,” “We Rewrote It in X,” and “How We Built It”—and helps you match these patterns with your ideas. This book covers the entire writing process, from brainstorming, planning, and revising, to promoting your blog in ways that build reputation and generate further opportunities.

What's inside

• Rapidly plan, draft, and review your content
• Build on popular blog post design patterns
• Support your writing with AI
• Increase the impact of all your communications

About the reader

For developers and engineers of all ability levels—even if you’re not a native English speaker and never took a writing class in your life.

About the author

Piotr Sarna is a software engineer and an experienced book and blog author. Cynthia Dunlop has been writing for and with developers for 20+ years.

Table of Contents

Part 1
1 Why write
2 What to write
3 Captivating readers
Part 2
4 Creating your working draft
5 Optimizing your draft
6 Getting feedback
7 Ship it
Part 3
8 The “Bug Hunt” pattern
9 The “Rewrote It in X” pattern
10 The “How We Built It” pattern
11 The “Lessons Learned” pattern
12 The “Thoughts on Trends” pattern
13 The “Non-markety Product Perspectives” pattern
14 The “Benchmarks and Test Results” pattern
Part 4
15 Getting attention
16 From blog post to conference talk
17 So you want to write a book
A Publishing and writing resources
B AI uses and abuses

About the Author

Piotr Sarna is a fearless technologist who dives headfirst into fun engineering challenges like forking SQLite for modern distributed apps, introducing Rust & Wasm into C++ projects, and contributing to the Linux kernel. He’s an experienced book author, tech reviewer, speaker, and blog author. Piotr graduated from University of Warsaw with an MSc in Computer Science.

Cynthia Dunlop has been writing for and with developers for 20+ years, covering topics across C/C++, Java, testing, DevOps, and back-end infrastructure. She’s behind several technical books, hundreds of articles, and countless blogs. Cynthia holds a BA from UCLA and an MA from Washington State University, where she taught writing once upon a time.

Ebook License

End-User Warranty And License Agreement

1. Grant Of License

Manning Has Authorized The Download By You Of An Unrestricted Number Of Copies Of The Electronic Book (Ebook) In Any Of The Available Formats. Manning Grants You A Nonexclusive, Nontransferable License To Use The Ebook According To The Terms And Conditions Herein. This License Agreement Permits You To Install The Ebook On Any And All Your Devices For Your Personal Use Only.

2. Restrictions

You Shall Not: (1) Share, Resell, Rent, Assign, Timeshare, Distribute, Or Transfer All Or Part Of The Ebook Or Any Rights Granted Hereunder To Any Other Person; (2) Duplicate The Ebook, Except For A Single Backup Or Archival Copy; (3) Remove Any Proprietary Notices, Labels, Or Marks From The Ebook; (4) Transfer Or Sublicense Title To The Ebook To Any Other Party.

3. Intellectual Property Protection

The Ebook Is Owned By Manning And Is Protected By United States And International Copyright And Other Intellectual Property Laws. Manning Reserves All Rights In The Ebook Not Expressly Granted Herein. This License And Your Right To Use The Ebook Terminate Automatically If You Violate Any Part Of This Agreement. In The Event Of Termination, You Must Remove The Original And Any Copies Of The Ebook From All Your Devices.

4. Source Code Supplementary Material

Any Source Code Files Provided As A Supplement To The Book Are Freely Available To The Public For Download. Reuse Of The Code Is Permitted, In Whole Or In Part, Including The Creation Of Derivative Works, Provided That You Acknowledge That You Are Using It And Identify The Source: Title, Publisher And Year.

5. Limited Warranty

Manning Warrants That The Ebook Files, A Copy Of Which You Are Authorized To Download, Are Free From Defects In The Operational Sense That They Can Be Read By A Pdf Reader Or Epub Reader, Or Other. Except For This Express Limited Warranty, Manning Makes And You Receive No Warranties, Express, Implied, Statutory Or In Any Communication With You, And Manning Specifically Disclaims Any Other Warranty Including The Implied Warranty Of Merchantability Or Fitness Or A Particular Purpose. Manning Does Not Warrant That The Operation Of The Ebook Will Be Uninterrupted Or Error Free. If The Ebook Was Purchased In The United States, The Above Exclusions May Not Apply To You As Some States Do Not Allow The Exclusion Of Implied Warranties. In Addition To The Above Warranty Rights, You May Also Have Other Rights That Vary From State To State.

6. Limitation Of Liability

In No Event Will Manning Be Liable For Any Damages, Whether Arising For Tort Or Contract, Including Loss Of Data, Lost Profits, Or Other Special, Incidental, Consequential, Or Indirect Damages Arising Out Of The Use Or Inability To Use The Ebook.

7. General

This Agreement Constitutes The Entire Agreement Between You And Manning And Supersedes Any Prior Agreement Concerning The Ebook. This Agreement Is Governed By The Laws Of The State Of New York