---
title: Introduction to Technical Writing
slug: books/technical-writing
icon: 🐣
createdAt: 2025-04-29T17:04:01.618Z
---

:::BlockQuote
🤔

**Why this playbook exists?**
:::

This playbook is an introduction to technical writing. It’s practical, straightforward, and just a touch more entertaining than the average style guide.

It’s aimed at new technical writers but doesn’t assume you’ve already memorized a dictionary. It should also come in handy if you’re a part-time documentarian. That includes developers, business analysts, or anyone who’s just been told, “Can you write this up quickly?” and knows that quick rarely means quick.

# What Is Technical Writing, Anyway?

At its core level, technical writing is all about making complex information easier to understand. If this sounds vague, it's because technical writing is a vast domain and not that easy to describe in a sentence. Sometimes it's not even technical and doesn't include writing!&#x20;

(That said - this playbook will focus on the written type of documentation, especially in the software world.)

## Some examples of technical writing

- **The manual&#x20;**&#x74;hat came with your washing machine
- **[The Archbee documentation](https://docs.archbee.com)**
- **IKEA diagrams**
- A programming languag&#x65;**&#x20;API reference**
- **Standard operating procedures&#x20;**&#x66;or servicing an airplane

::Image[]{src="https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/Nm7fJfRz5chcWensKEPuz_image.png" size="60" width="600" height="600" position="center" caption="Alien assembly instructions, by Ed Harrington" alt="Alien assembly instructions, IKEA style, by Ed Harrington" darkWidth="600" darkHeight="600" showCaption="true"}

The day-to-day tasks of a technical writer are different from role to role, but technical writing in general has the following characteristics:

- **Clear and concise** - avoids unnecessary words and uses straightforward language.
- **Structured and organized** - uses headings, lists and sections for easy reading.
- **Objective and neutral** - focuses on facts rather than opinions or emotions.
- **Instructional** - often includes step-by-step guidance or explanations.
- **Visual elements** - may include diagrams, tables or charts to support understanding.

# What *Isn't* Technical Writing?

## Creative Writing

As is obvious from the name, creative writing is almost the opposite of technical writing.&#x20;

:::DropList
```json
{
  "columns": [
    {
      "id": "1",
      "name": "🎭",
      "items": [
        {
          "id": "GXNburEtPPynQ6FB5PlUl",
          "content": "Creative writing",
          "justAdded": false
        },
        {
          "id": "qXq-o9X9r--X8kNwgOfyY",
          "content": "More artistic, aiming to entertain or evoke emotions and prioritizing style over clarity.",
          "justAdded": false
        }
      ]
    },
    {
      "id": "2",
      "name": "👨‍🏫",
      "items": [
        {
          "id": "hV7q30mGT1vfGqKUz2hx8",
          "content": "Technical writing",
          "justAdded": false
        },
        {
          "id": "PdFyH8i0ApBvH-0AfDp_W",
          "content": "Factual and structured, aiming to instruct or explain.",
          "justAdded": false
        }
      ]
    }
  ]
}
```
:::

::embed[Moving back and forth between writing styles can be difficult, but there are a few famous authors who managed it successfully. A few examples are [Thomas Pynchon](https://www.altaonline.com/dispatches/a6465/thomas-pynchon-unmasked/) (author of *Gravity's Rainbow*), [Becky Chambers](https://youtu.be/Q4if_CB4o6g?t=394) (author of *The Long Way to a Small, Angry Planet*) and [Ted Chiang](https://boingboing.net/2010/07/22/ted-chiang-interview.html) (author of *Story of Your Life*, the novella adapted into the movie *[Arrival](https://www.imdb.com/title/tt2543164/)*). ]{url="https://youtu.be/Q4if_CB4o6g?t=394"}

::Image[]{src="https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/pjYi2ef2NQVpC5nC2rD63_hjbakdfrryel5mnfeqoj5-image.jpg" size="80" width="800" height="647" position="center" caption="When a technical writer tries to write a thank you note" alt="Meme - When a technical writer tries to write a thank-you note" darkWidth="800" darkHeight="647" showCaption="true"}

## Technical Content Writing

Technical writing and technical *content* writing are often confused one for the other, for obvious reasons. While they do have their similarities, the two terms cannot be used interchangeably.&#x20;

:::DropList
```json
{
  "columns": [
    {
      "id": "1",
      "name": "📢",
      "items": [
        {
          "id": "eH-nVgzCCMH9atyeohsH4",
          "content": "Content writing",
          "justAdded": false
        },
        {
          "id": "GFu9HBj5dj2h_BUh-t3o_",
          "content": "Aimed at a broad audience and is more focused on storytelling, SEO or marketing.",
          "justAdded": false
        }
      ]
    },
    {
      "id": "2",
      "name": "🎯",
      "items": [
        {
          "id": "mNCDI7V05wAC0FUVRt51J",
          "content": "Technical writing",
          "justAdded": false
        },
        {
          "id": "kQ42J9TzbNAQ9v8E-ytm0",
          "content": "Targeted at the users of a product and focuses on helping them accomplish specific tasks. ",
          "justAdded": false
        }
      ]
    }
  ]
}
```
:::

That being said, experience in content writing can be useful for someone trying to transition into technical writing, since both fields involve simplifying complex information, adherence to grammatical and stylistic standards, and deep research into technical topics.

## Academic Writing

Writing is a large part of life in academia, but it follows different conventions than technical writing.

:::DropList
```json
{
  "columns": [
    {
      "id": "1",
      "name": "⚖️ ",
      "items": [
        {
          "id": "q7yPndg49WvT1H95W1Oas",
          "content": "Research papers",
          "justAdded": false
        },
        {
          "id": "gFc883-6e76TNuJxk-z0_",
          "content": "Focus on analysis and argumentation, generally using long sentences, abstract language and dense jargon. To sound objective, academic writing uses passive voice.",
          "justAdded": false
        }
      ]
    },
    {
      "id": "3",
      "name": "🛠️",
      "items": [
        {
          "id": "VobjgTm94hC4GT2CD0h2T",
          "content": "Technical writing",
          "justAdded": false
        },
        {
          "id": "j4YaX7n5NCrT6zL-s-1nJ",
          "content": "Focuses on practical information, using clear language and simplified explanations. Since it's meant to actively instruct users, technical writing uses active voice. ",
          "justAdded": false
        }
      ]
    }
  ]
}
```
:::

## Journalistic Writing

Good writing and adherence to a style guide is critical for journalism, but there are also significant differences compared to technical writing.

:::DropList
```json
{
  "columns": [
    {
      "id": "1",
      "name": "📰",
      "items": [
        {
          "id": "3gM5uZPv832oyLxIrwWSg",
          "content": "Journalism",
          "justAdded": false
        },
        {
          "id": "bpVwZSdCdx-8Kt9iNab14",
          "content": "Focuses on storytelling or current events, often using an engaging and dynamic style to capture readers' attention.",
          "justAdded": false
        }
      ]
    },
    {
      "id": "3",
      "name": "🗺️",
      "items": [
        {
          "id": "JVGcjZDBl48oBjFABcN7d",
          "content": "Technical writing",
          "justAdded": false
        },
        {
          "id": "ndnmwHi2bhwuskz0oQjJL",
          "content": "Uses neutral language to guide the users through a process, without eliciting an emotional response.",
          "justAdded": false
        }
      ]
    }
  ]
}
```
:::

# Transferrable Skills

The previous section focused on the ways other types of writing are *not* technical writing. However, this does not mean that journalists or content writers don't have a lot of experience that can be leveraged into technical writing!&#x20;

The [Essential Skills for Technical Writing](#) section focuses on the skills that a successful technical writer needs.
