Kesteven and Associates Presentation

Documentation that people will read

Home | Services | Training | SilkWrite | Portfolio | Partners | Contact

The reader is a customer. The documentation (strictly, the information in the documentation) is the product. If the product is not up to standard, you lose your customer: your documents go unread.

At a minimum, documentation should be:

Short. Literacy levels are low; and people are in a hurry. For many readers the practical limit is about one page: any more than that and it's easier to go and ask someone.

Simple. Most documentation is instruction: who does what. Narrative prose doesn't work. Hardly anyone can write it; no-one will read it.

Consistent. The terminology and style of the documents must be rigorously consistent. The language should match your forms and other paperwork, and your site signage.

Accessible. Literacy is not only the ability to understand a page of writing; your reader must also be able to find the page (bearing in mind that 30 percent of adults can't use the Yellow Pages).

 

Adult literacy performance

Percentage incorrect

Test item

English-speaking background

Non-English background


Drivers licence: circle expiry date

3

9

Map: locate intersection

3

7

Deposit slip: enter cheque details

4

6

Yellow Pages: find phone number

8

12

Deposit slip: enter cash details

12

26

Pay slip: read gross pay to date

15

29

Yellow pages: find heading

25

36

Paint chart: identify use

25

36

Charge account: write cheque

28

50

Job application: complete past details

31

52

Paint chart: select product

38

47

Medicine label: correct dosage for child

45

48


Based on Wickert, R. No Single Measure: A Survey of Australian Adult Literacy. Commonwealth Department of Employment, Education and Training, Canberra 1989.