Technical writing audience EE

From Wikiversity

Jump to: navigation, search

back to Technical Writing Level 1

Only write what your reader does not already know.

Picture Copyright SitronicsTS 2007 text by kind permission of Sitronics TS Czech republic

[edit] Personas Lesson Plan

Contents


[edit] Personas

It is vital that you do not waste your reader's time. It is also important that you do not waste you own time by explaining things that the reader already knows. The reader usually starts reading your document because there is a problem with the equipment or software. The reader must get the equipment or software working again quickly.

This module introduces the use of a typical reader or persona to help make writing more consistent. The best way to save your reader's time is to only tell them information that they do not already know. Always focus on the task the user wants to complete, and describe it simply and directly.

[edit] Definitions

A reader is a person who will use your documents. A persona is a theoretical person who matches a typical example of the people who will use your documents.

[edit] How can you select the correct information if you do not know who you are writing for?

You do not need to do research yourself. The marketing department can tell you a lot about the customer. If there is no information then you can make some assumptions based on the type of document.

[edit] Questions to ask your marketing department

  1. What type of education does the reader have?
    • An Engineer will have a degree with some computer studies included
    • A Call centre operator or shop employee may only have basic education so explain more basic concepts
  2. If the software is an upgrade then the reader has used a similar product before. Point out the differences between the two versions first. This may save the reader time
  3. Create a persona based on this research
  4. Write an introduction to a product for your persona

[edit] For the exercise

You need:

  • A picture of a typical document user. You can cut out a photo from a trade magazine
  • A product to write about
  • A new page on Wiki or Confluence

[edit] Exercise 1

Write "How to make coffee" in steps for a teenage relative with no experience

[edit] Exercise 2

Write "How to make coffee" in steps for a 45 year old Aunt.

[edit] Exercise 3

Write "How to make coffee" in steps for a 28 year old Assistant

for answers to the questions contact snuzprague@yahoo.co.uk

[edit] Exercise 4

Create a persona. Make the Persona as close as possible to your real average reader. For the exercise you need:

  • A picture of a typical document reader. You can cut out a photo from a trade magazine
  • A product to write about

There two basic questions:

  1. What information does your reader need?
  2. Where will they use this information? (in a call centre, in a shop, in an equipment room)

[edit] Hint for Excercise 1

Write "How to make coffee" in steps for a teenage relative . Perhaps some pictures of the items and locations would help

[edit] End of Lesson Questions

  1. What influences the information that your reader needs?
  2. What is the difference in the amount of detail required in Exercises 2, 3, and 4?
  3. Do you have to give the same level of information to your Aunt as the teenager?
  4. Why do you have to give more details to the teenage relative?


[edit] Next Module

Researching and interviewing(EE) How to interview experts (SMEs)

[edit] Previous Module

back to Technical writing Overview (EE)


[edit] General

How to edit Wiki

Wikiversity Main Page

[edit] Further Reading

Retrieved from "http://en.wikiversity.org/wiki/Technical_writing_audience_EE"