Design: User Assistance Design

Simplified Technical English (STE) and minimalism are of great importance in writing user-friendly documentation, particularly for user content such as maintenance manuals. However, many technical writers experience specific problems when implementing STE and minimalism. The ASD-STE100 Specification is a complex document, and a disadvantage of this approach is its expensive learning time. Plus, literature about minimalism comprises complex documents, and training is scarce.

In this article, we’ll clearly describe the steps you need to take to implement the principles of Simplified Technical English and minimalism in designing optimized, user-friendly documentation. First, we’ll cover the concepts behind the Thumbs-Up Technique—principally, STE and minimalism. Next, we’ll detail the steps to follow in implementing STE. Finally, we’ll detail the steps to follow in implementing minimalism. By following the steps we’ll outline, you can apply the principles of STE and minimalism to your documentation quite easily. Read More

The profession of technical writing is on the verge of obsolescence! If you are a technical writer, you need to open your eyes to this reality. The current industry trend shows that hiring managers are looking for people who can fill more than one critical role. With many programmers, quality-assurance testers, analysts, and consultants taking on technical writing, it will eventually become impossible to sustain a career solely as a technical writer without any hands-on technical or analytical experience.

To survive in the ever-changing IT industry, it is essential that technical writers keep honing their skills to avoid becoming dispensable. As the saying goes, it is never too late to learn something new. In this article, we’ll describe some of the proficiencies you should consider acquiring in addition to your technical writing skills. Read More

UX writing involves designing copy for user-interface (UI) elements that users employ in interacting with applications. This copy includes labels for menu items, commands, buttons, and form controls; error-message text, alert text, and other instructional text.

To ensure a good user experience, it is essential to design user-interface text to be accessible to users with different abilities, regardless of how users navigate the software—whether using speech, keyboard, or mouse device—or if users have color-deficient vision. UX writing must serve all types of users and help them interact with a user interface successfully. In this article, we’ll provide some guidelines for effective UX writing. Read More