Techie Writing - Two Different Types involving Software User Manuals

Drag to rearrange sections
Rich Text Content
In technical writing, there are two various but related types of software user manuals and I phone them "Button Guides" and "Procedural Tutorials".

SOME CONTROL GUIDE clarifies what each "button", or maybe the graphic end user interface (GUI) factor that one perceives on a display is and does indeed.

For example, this sort of button guide would likely explain that when you click typically the File menu alternative, a drop-down record will display some other sub-options including Preserve and Save Seeing that, etc.

Best employee directory explain in some sort of static manner exactly what the response can be when a person click on various textual content links, menu choices and command control keys.

These are relatively simpler to write since all you need will be the software itself. Even a beginning specialized writer can click on her way all-around the GUI in addition to write down the girl observations. The result is a simple inventory of screen element manners.

A PROCEDURAL ARTICLE, however, is a new much harder doc to write mainly because it requires not really only a comprehensive familiarity with "which key does what, inch but additionally an being familiar with of the standard functionalities, basic results that the computer software delivers.

It requires an understanding of how the clients (end users) actually carry out use the software in addition to what they anticipate the software to accomplish.

Once the writer has a clear thought with what the application is supposed in order to accomplish, then she can identify the procedures that happen to be most important to the user and with regard to the program administrator which is designed to set up the system.

Typically the writer's task is always to break down these procedures into continuous, mutually exclusive and non-redundant steps so of which the user could follow the tutorial easily.

These happen to be the sort regarding complex documents of which novice technical copy writers find harder to author. But without such procedural training, a "button guide" alone is not necessarily enough to relieve customer frustration.

Exactly why frustration? Imagine a person are trying to be able to fly an plane along with the "User Guide" you might have identifies and explains what every single and every portion and button by using an airplane does WITH NO however actually outlining what sequential ways you need in order to take (in precisely what sequence and combo you need in order to use all individuals buttons and controls) as a way to fly typically the airplane. Wouldn't an individual be frustrated in the event that you lacked many of these a procedural training?

An ideal software program manual set contains BOTH types associated with manuals considering they are complementary and equally needed.

rich_text    
Drag to rearrange sections
Rich Text Content
rich_text    

Page Comments

No Comments

Add a New Comment:

You must be logged in to make comments on this page.