Issues within Manual Writing

An error occurred trying to load this video.

Try refreshing the page, or contact customer support.

Coming up next: Standard Operating Procedure (SOP): Purpose, Content & Structure

You're on a roll. Keep up the good work!

Take Quiz Watch Next Lesson
Your next lesson will play in 10 seconds
  • 0:01 Problems with Manual Writing
  • 0:46 Usability
  • 1:27 Addressing Usability Concerns
  • 2:19 Updates
  • 2:52 Addressing Updates
  • 3:35 Lesson Summary
Save Save Save

Want to watch this again later?

Log in or sign up to add this lesson to a Custom Course.

Log in or Sign up

Speed Speed
Lesson Transcript
Instructor: Kevin Newton

Kevin has edited encyclopedias, taught middle and high school history, and has a master's degree in Islamic law.

Manual writing is a crucial part of making any product really usable to the final customer. However, as this lesson will demonstrate, there are a number of issues that the technical writer needs to be aware of.

Problems with Manual Writing

Manuals can be tricky to write. Foremost, they are rather substantial documents. Second, they have to be useful to the user, whom will likely only refer to them in moments of frustration. After all, how many people really thoroughly understand the directions before using a product? Finally, most products are constantly being updated, so the manuals themselves have to leave room for updates. In this lesson, we'll look at these problems that face manual writers by looking at how to address them with the sort of product that has many of these problems: an office productivity suite. We'll first focus on usability before moving on to how to address updates.


At the end of the day, the ability of the client to be able to use a program is one of the most important parts of the client-company relationship. It could be the most useful software suite in existence, but if the client can't figure out how to enter data, then it is absolutely useless. Ideally, all products would be usable from out of the box; however, that simply isn't going to happen. Instead, manuals have to make sure that their procedures describe how to use all aspects of a product. Imagine having to write in a word processor without knowing how to use the cursor, much less a spell check function. A good manual will quickly address these issues, putting the user at ease.

Addressing Usability Concerns

One of the best ways to quickly address usability concerns is to make sure that the language throughout the manual is accessible. Again, this depends on your audience. If you are writing a general office program manual, then you will have to use less specialized language than someone writing a manual to a program marketed only to accountants or financial managers.

Additionally, it's not just that the language itself must be usable, but also the document should be organized in such a way to make it wholly useful. Imagine having to skip around the whole manual because someone didn't put the topics in a logical order. Users will not be happy about having to turn to page 500 to find out how to change the font size. In fact, this is why many successful manuals use a quick reference guide to allow users to quickly find the most basic procedures.

To unlock this lesson you must be a Member.
Create your account

Register to view this lesson

Are you a student or a teacher?

Unlock Your Education

See for yourself why 30 million people use

Become a member and start learning now.
Become a Member  Back
What teachers are saying about
Try it risk-free for 30 days

Earning College Credit

Did you know… We have over 200 college courses that prepare you to earn credit by exam that is accepted by over 1,500 colleges and universities. You can test out of the first two years of college and save thousands off your degree. Anyone can earn credit-by-exam regardless of age or education level.

To learn more, visit our Earning Credit Page

Transferring credit to the school of your choice

Not sure what college you want to attend yet? has thousands of articles about every imaginable degree, area of study and career path that can help you find the school that's right for you.

Create an account to start this course today
Try it risk-free for 30 days!
Create an account