Adobe DITA World 2018
Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers

Stitcher radio

Search results

Adobe DITA World 2018

Tech comm trends: Providing value as a generalist in a sea of specialists (Part I)

Part I: Introduction and argument overview

by Tom Johnson on Oct 2, 2018
categories: api-docsimplifying-complexitywriting

Technical writing jobs have shifted more from the end-user domain to the developer domain. This creates challenges because most technical writers are generalists, not specialists, when it comes to technology they document. In these specialist contexts, technical writers can add value by focusing on authoring/publishing processes and tools, knowledge of the user experience, and information usability.

Series summary

Developer tools and languages are becoming increasingly specialized and complex, requiring engineers to play more active, collaborative roles in documentation. The market opportunities for tech writers have gravitated toward this complexity, with most of the jobs in demand involving developer documentation.

Yet tech writers are typically generalists, so they face real challenges when it comes to providing value in these specialized contexts. What value can generalists provide in a world of increasing specialization? How can you avoid becoming a second-class citizen in developer contexts?

Even without a specialist’s in-depth knowledge, tech writers can still play powerful roles in shaping documentation. Tech writers can provide value as generalists even in a sea of specialists by (1) instrumenting the publishing workflow and platform, (2) relaying knowledge of the user experience, and (3) implementing information usability.

Introduction

As a blogger who carefully looks at metrics (whether it’s clicks on newsletter articles or web traffic analytics), I have a sense of what topics resonate with readers. Without a doubt, one topic that gets the most clicks, year and year out is the topic of trends.

Exactly why the topic of trends is so popular, and whether bloggers have any special insight about trends, is not something I’ll go into. But I will tackle the subject of trends in a more head-on way in this essay.

What trends will I be covering? Chatbots, augmented reality, or maybe even the singularity? No. I’m focusing on trends toward specialization and complexity and how they affect tech comm professionals, who tend to be generalists. The tensions between specialists and generalists seems to articulate a key reason why tech comm professionals often feel undervalued.

Argument overview

In a nutshell, my argument is this:

  • Technology is becoming increasingly specialized, particularly with developer documentation.
  • Since tech writers are generalists, the task of documenting specialized technology often becomes daunting.
  • Because the information is so specialized, many developers participate and collaborate in the authoring process.
  • To provide value in specialist contexts, tech writers can focus on (1) authoring/publishing processes and tools, (2) knowledge of the user experience, and (3) information usability.

I’ll dive into each of these points in depth.

Interactive surveys

On each page, I include a short survey to gather your responses and input. Through these surveys, I’m hoping to gather some professional consensus about a lot of the points I make here. I want to know if I’m advancing ideas that seem shaky or that don’t align with your own experience. Ideally, everything I write or argue for would be meticulously based on lengthy research and studies; however, that isn’t always possible, so I’m hoping to leverage your own experiences and insights to get more confirmation.

Slides

I’m giving several presentations related to this series topic. For a slide presentation, see idratherbewriting.com/trends-generalists-specialists/. You can also download a PDF of the slides here.

Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers

follow us in feedly