4  How to write for the web

Summary

Good writing is easy to read and understand. It uses short sentences, simple vocabulary and is broken into chunks.

Chapter 3 discussed the observations that:

And how page structure can make scanning easier and information easier to retain.

However, we can also address these issues through our writing, primarily by:

NN/g also have a page collating articles and videos specifically related to writing for the web based on their research: NN/g UX Writing: Study Guide

4.1 How to write better sentences

My favourite resource for improving writing is a short paper by Jonathan Bennett and Samuel Gorovitz in which they describe ‘Bennett Rules’ for sentences1.

I’ve extracted the Bennett Rules here, but I encourage you to read the whole thing as it provides greater context and explanation.

A key point is that comparison is often the best way to understand whether we can improve a sentence.

  1. Verbs are better than nouns. Compare:

    There is a difference between waving and drowning.

    Waving differs from drowning.

  2. Adverbs are better than adjectives. Compare:

    She is a clear writer.

    She writes clearly.

  3. Favour the Anglo-Saxon. Compare:

    Is it possible for him to…? (possible has Latin roots)

    Can he…? (can has Anglo-Saxon roots)

  4. Banish ‘very’ and its ilk. Compare:

    It’s very unlikely.

    It’s unlikely.

  5. Abstract nouns should be fought like the devil. Compare:

    Our exploration of the formulations’ implications for readability reveals that each are unacceptable.

    We explore what each formulation implies for readability and find that none are acceptable.

  6. Avoid undue repetition.

  7. Be careful with commas. I’d extend this rule to suggest that breaking long sentences into smaller ones is generally good advice. Sentences full of commas, semi-colons and colons are potentially more confusing and harder to read.

  8. Attend to the sound. Test your writing by reading it aloud.

As discussed in Section 3.3 , the purpose of these rules is to provide practical guidance when creating your content. You may decide a more verbose or Latin rooted construction works best. The aim is to help you think about how to write sentences that the user will find easy to read and understand.

4.2 Make link text informative

When linking, rather than “here”, “more” or “go”, use descriptive text or the page title as the link such as this link to Wikipedia’s photo of a domestic rabbit stretched out on a carpet.

Links with descriptive text are helpful for anyone using a screen reader and for all users in understanding what a link leads to.

4.3 Editing your own words

It is difficult to edit ones own words. Over-familiarity leads to word-blindness and an inability to spot typos. And it is difficult to step outside of oneself and consider how our words come across to someone else.

Ideally one would have an editor available to review and copy-edit our words, but this isn’t always possible. If you are unable to recruit a trusted colleague to review your writing, Hannah Boursnell has written a two part blog with advice on how to edit your own work: 10 editing hacks - Part 1 and 10 editing hacks - Part 2.

Perhaps the key advice being:

  1. Take a break to overcome word-blindness. Take a walk or leave it overnight.
  2. Start editing with the big picture: overall structure, headings, formatting - with the question, Is this achieving what I set out to do? in mind.
  3. Then move onto finer grained edits: paragraphs, sentences, words. Returning to the question in 2.
  4. Check for consistency in writing style. Both within your page and compared with other pages on the site your page will inhabit.
  5. Back-up or version control your writing such that you can reinstate any changes if you change your mind.