Technical writers are often hired to solve a burning problem within an organization, such as lowering support costs, streamlining customer onboarding, or increasing organizational efficiency.
But company leadership typically has an unclear understanding of the technical writing discipline and a vague idea of the outcomes they're seeking. Often the only directive is, "I want docs like Stripe."
This often leads to unrealistic expectations. A single technical writer is expected to do many jobs: write the docs, make the videos, manage the tools, organize the docs, create and enforce the style guide, define the docs processes, own the search functionality, improve SEO, manage the analytics, update the docs, and teach their teammates how to write docs. "We hired a technical writer. It's been 6 months. Why aren't our docs like Stripe's yet?"
Each of these components is time-consuming and requires the honing of specific skills; not to mention loads of time and energy.
But now coding agents allow us to automate common tasks that get in the way of our main objective: to make customers successful.
As technical writers, we have a chance to capitalize on this moment. We can have a greater impact on the industry if we evolve our skills and measure our impact through the lens of Knowledge Engineering. We can convey the increased impact of our skills to help companies get the most out of AI.
In an environment where AI gets increasingly better at coding, Knowledge Engineering is one of the most important disciplines in an organization: managing documentation, context, and internal knowledge for your company's endless sea of AI-generated code.
Knowledge Engineering will play a critical role in the coming decades as the industry works on increasingly harder problems in software, hardware, robotics, and life sciences. As writers, educators, and information architects, our jobs will be more important than ever to translate complex technology into better user experiences—while increasing productivity for ourselves and our peers.
Now when leadership says they want world-class docs, make sure the expectations are set on what that actually requires.