Document 360: #1 Knowledge Base Software
Stay updated
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 5,400+ subscribers

Search results

Document 360: #1 Knowledge Base Software

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

Tech comm trends: Providing value as a generalist in a sea of specialists

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.
<div class="btn-group">
    <button type="button" data-toggle="dropdown" class="btn btn-warning dropdown-toggle">Tech comm trends: Providing value as a generalist in a sea of specialists<span class="caret"></span></button>
    <ol class="dropdown-menu">
        
        
        
        <li class="active"> → Part I: Introduction and argument overview</li>
        
        
        
        <li>
            <a href="/2018/10/02/providing-value-as-generalists-in-specialist-contexts-part-2/">Part II: Why tech writer jobs are moving toward the developer domain</a>
        </li>
        
        
        
        <li>
            <a href="/2018/10/02/providing-value-as-generalists-in-specialist-contexts-part-3/">Part III: Gaps in documentation tooling and processes</a>
        </li>
        
        
        
        <li>
            <a href="/2018/10/02/providing-value-as-generalists-in-specialist-contexts-part-4/">Part IV: User knowledge and understanding</a>
        </li>
        
        
        
        <li>
            <a href="/2018/10/02/providing-value-as-generalists-in-specialist-contexts-part-5/">Part V: Information usability principles</a>
        </li>
        
        
        
        <li>
            <a href="/2018/10/02/providing-value-as-generalists-in-specialist-contexts-part-6/">Part VI: Information usability principles continued</a>
        </li>
        
        
        
        <li>
            <a href="/2018/10/02/providing-value-as-generalists-in-specialist-contexts-part-7/">Part VII: Conclusion</a>
        </li>
        
        
    </ol>
</div>

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 updated
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 5,400+ subscribers

follow us in feedly

About Tom Johnson

Tom Johnson

I'm a technical writer based in the San Francisco Bay area. In this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, visual communication, information architecture, writing techniques, plain language, tech comm careers, and more. Check out simplifying complexity and API documentation for some deep dives into these topics. If you're a technical writer and want to keep on top of the latest trends in the field, be sure to subscribe to email updates. You can also learn more about me or contact me.

Comments