More Than a Support Function :: UXmatters

Improving Existing Content

Whenever you get time between releases, read the product’s existing content, be sure you understand it, and make a list of topics that need improvement.

Here are a few suggestions for improving existing content about your product:

    • Remove deprecated and redundant content.
    • Correct grammatical errors.
    • Apply your company’s style guide.
    • Add figures and workflow diagrams.
    • Add example codes.
    • Improve the flow of information across topics and chapters.
    • Restructure topics for clarity.
    • Divide lengthy topics into subtopics.
    • Highlight important features of the product.

Discuss your findings with your group’s or the company’s editor. An editor is the best person to guide you in improving the content.

As Figure 2 shows, the process for improving existing content differs somewhat from that for writing new content.

Figure 2—Workflow for improving existing content
Workflow for improving existing content

Automating Processes

In many documentation processes, technical writers do all of their work manually, which consumes a lot of time and effort. You can automate certain processes by learning scripting languages such as Perl, JavaScript, and AutoHotkey. Scripting languages can also be helpful in the process of releasing documents. Unlike software or hardware programming languages, scripting languages are easy to learn. Plus, there is a lot of information about automating documentation processes on the Web. Learning new scripting languages and operating systems such as UNIX and Linux helps you to increase your technical expertise, enabling you to better understand the work your R&D team is doing.

Creating Videos and Tutorials

Many users prefer watching videos instead of reading lengthy documentation. Create short, interesting videos to explain new or complex features. Create tutorials to explain the product’s basic workflows or how to accomplish specific tasks using the product. You could also create a video book that comprises a series of videos. Check out similar content on the Web and look for ways to refine your videos and tutorials.

Discovering Product-Related Issues

As you work on improving a product’s content, you should simultaneously work on understanding the product better. You can increase your credibility with the team by discovering issues with the product. While you can easily find issues in a GUI-based tool, finding issues in a command-line tool can be challenging. Most technical writers do not have a very technical background, so working on a UNIX-based product may seem to be a herculean task. But with consistent effort, you can succeed and will be able to create a name for yourself among other technical writers.

Providing Product-Improvement Suggestions

In your free time, try various product features, use different input patterns and observe the output, and identify ways in which you can add value. Gradually, with time and experience, you’ll get ideas for improving the product.

Here are a few areas in which you can provide help:

    • Identify product features that are not easy to use.
    • Offer to rewrite ToolTips that are difficult to comprehend or don’t make sense.
    • Call out areas in which product-generated reports don’t provide insufficient information.
    • Offer to rewrite error messages and warnings that are not descriptive or are incorrect.
    • Identify command Help text that isn’t sufficiently descriptive or is incorrect.
    • List features, commands, arguments, or options that are redundant.

Discuss your product-improvement suggestions with your marketing and R&D team.

Writing Technical Articles for the Web

Once you understand the product and your industry, write technical articles for the Web. Because you are a writer, you can better express basic concepts for your product and industry and help people to understand them. Before writing about your company’s product, be sure to get your manager’s approval. You could also write articles about the documentation process you follow or any scripts or utilities you’ve developed.

Improving Your Peers’ Technical Knowledge

Most technical writers come from a nontechnical background. To help your technical-writing peers, you can prepare an induction program for new team members to help them understand the technology, your product, and your industry. You can also learn about your division’s other products, then offer a helping hand with them.


Technical writing is a good field in which to work. In addition to your primary responsibility of writing, you should be ready to take up new challenges and add value to the product you’re documenting. By gaining insights on the product, you can help the company achieve its product-development targets. In a time when companies are increasingly pursuing cost-cutting initiatives, it is important that you contribute in more areas than just writing and that you become more productive. So, as a technical writer, rather than just being part of a support function, figure out ways in which you can contribute to the development of the product! 

Source link