Part II

Technical Writing: Your Engineering Superpower

How to Write Well

Sophie DeBenedetto
The Pragmatic Programmers
8 min readJul 9, 2021

--

How to be a successful technical writer in your everyday life as a dev and beyond.

In Part I of this two-part series, you saw the many types of technical writing that show up in your day-to-day life as an engineer. Here’s Part I, in case you want to start there:

You saw also why technical writing plays an important role in your work. In Part II, I’ll share some tips and guidelines for tackling each type of technical writing that you’re likely to encounter.

Let’s start with the first type of technical writing we discussed — blogging.

How To Blog

Photo by Avel Chuklanov on Unsplash

While writing a technical blog can seem daunting, in reality, there are just two steps:

  1. Pick a topic.
  2. Write about it!

Okay, so maybe it’s not quite that easy. Let’s break down the process.

--

--

Sophie DeBenedetto
The Pragmatic Programmers

Sophie is a Senior Software Engineer at GitHub and co-author of Programming Phoenix LiveView