top of page

A writer’s job is to simplify complexity



 

The most popular answer when you ask a technical writer what they do is that they “simplify complexity.” Technical writers find out user goals and create clear guidance about how users can achieve the goals in complex systems (supporting multiple activities, choices, functions, and information). The ability to simplify information in complex structures is the technical writer’s most valuable asset.


However, despite all of the discussion about simplifying complexity, there isn’t much information available about how to do it. How do you make complicated processes and definitions easy to understand? How do you assist users in achieving their objectives in the face of complex, confusing applications and code? It’s a good start to explain concepts in plain language and to use task-based measures, but it’s not the whole picture. Technical writers should focus on what users find difficult and use all of the resources at their disposal to increase the convenience factor in ways that bring real value to organizations.


The thought that a technical writer’s central value is to assist users in making sense of complex structures fascinates me. We should focus our efforts on the user’s biggest issue because that’s where we can provide the most value and also where the room is most interesting. We don’t add value by recording plain, obvious instructions or by providing instructions for well-designed and intuitive interfaces and workflows. We add value by defining what users struggle with the most, their point of greatest difficulty and frustration, and then focusing our efforts on that whirlpool.


In the world of developer and API documentation, the job of simplifying complexity is much more challenging. Developers have a broader range of technological skills and knowledge than most technical authors. Despite this, technical writers can still help developers by simplifying knowledge in ways that are critical to their success.


I always believe that by learning the proper strategies and methods, we will be able to do a better job. In our positions, we will add more value. We will go beyond simply being seen as editors, authors, or publishers if we simplify ambiguity in deep ways. In information spaces, we become knowledge developers and usability experts.



18 views1 comment

1 Comment


Raghu M
Raghu M
Jul 13, 2023

Softpro9 is a leading provider of SAP training in Mangalore, offering comprehensive courses to individuals and businesses seeking to enhance their skills in SAP software. With a team of experienced trainers and a commitment to delivering high-quality education, Softpro9 has established itself as a trusted name in the industry.

Our SAP training programs cover a wide range of modules, including finance, human resources, supply chain management, and more. Whether you are a beginner looking to gain foundational knowledge or an experienced professional aiming for advanced certifications, Softpro9 has tailored courses to meet your specific needs.

What sets Softpro9 apart is our hands-on approach to learning. We believe that practical experience is crucial in mastering SAP software. That's why our training…

Like
Post: Blog2_Post
bottom of page