Skip to Content
Techniques

 

Techniques

1. Decide on who and why

2. Get to know the content

3. Put the best bit first

4. Slash everything else

5. Edit sentences

6. Put "if" before "then"

7. Demolish walls of words

8. Launch and land on the same name

9. Rest it then test it

6. Put "if" before "then"

Organise each sentence to make it work in a logical order. Then move the sentences around to put them in a logical order, too.

Get rid of "then" before "if"

Many of us find that we write "Do this if you want to achieve that", or "Do this unless that applies to you".

Unfortunately, many people will obey the "do this" part of the instruction without noticing the "if" or "unless" part.

Look through your content to ensure that "if" always comes before "then".

First things first, second things second

Often we want readers to do one thing then do another thing. Make sure you list them in the same order that you want them to be done.

Keep equivalent items parallel

When you have a bulleted or numbered list, make sure that the things in the list are all similar.

Example that's not parallel. The last bullet point is a new sentence, and not equivalent to the others.

Text that scrolls across the page is harder to read for:
* people with dyslexia
* anyone who speaks English as a second language
* It can also confuse some screenreaders, used by people who are blind

Example that is parallel.

Text that scrolls across the page is harder to read for:
* people with dyslexia
* anyone who speaks English as a second language
* people who use screenreaders


Try writing like a recipe

Many good cookbooks follow this format for recipes:

* title of the recipe
* why you might want to cook it
* the ingredients you need
* the list of things to do with them (the method)
* any variations

When you're writing a list of instructions, try writing them like a recipe.


Read more about putting instructions in order

More about order of instructions: Dixon, P. 1987. "The Processing of Organizational and Component Step Information in Written Directions" Journal of Memory and Language, 26, pp24-35, Academic Press, Inc.

"First things first, second things second" is adapted from 'Preserve temporal order' in Wright, P. and P. Barnard (1975). "‘Just fill in this form’ — a review for designers." Applied Ergonomics 6(4): 213-220.

Terence Eden (@edent) asks writers to put instructions in order: Do that after this