Best Practice Round-Up

Earnsy (rhymes with Guernsey) successfully completed the GDID (Graduate Diploma in Information Design, Ara) in 2017. She’s interested in many aspects of information design and is partial to flat whites. In her quarterly TechCommWire column, she looks for evidence (not just opinions) to help you manage the daily conundrums we face in our profession.

  • Alt text should be half a tweet long, they say May 2019
  • How would you know what an image was if you couldn’t see it? You’d need someone to describe it to you. That’s what alternative text (alt text) is: a text description of an image. It’s not a caption. It makes information accessible to everyone, including those who are blind or visually impaired, and anyone whose device doesn’t display images properly. But how much should you write?
  • How much do we read on our phones? March 2019
  • Alas, despite trawling through screeds of articles and reports, I don’t know how much users read on their phones. I can’t tell you that typical mobile phone users spend X min a day or Y per cent of their time reading. But hey, don’t go! Let me explain why I don’t have an answer (it depends what you call reading) and make it up to you with other interesting, related findings. Tell you what: I’ll even mention sex, love, and Kamasutra. (Don’t worry if you’re at work — it’s safe to keep reading.)
  • When should we use visuals? November 2018
  • To assemble that chair, start by inserting screw a6 into b1 while holding down c. Got that? No? Why not? It’s a short sentence (15 words) and there are no big words. Would visuals help? When are they a good idea, when not? What do users prefer? Let’s look at the evidence on the use of visuals, compare text and visuals, peek at a comic-style employment contract, and finish with some tips.
  • Asking about Gender August 2018

    Do technical communicators need to think about gender? I think so. We may be asked to review wording in forms or surveys, we may need to develop personas, and we need to ensure our writing doesn’t alienate readers and give them a bad user experience.

  • Deciding between words and tables May 2018

    Looked at the Super Rugby results lately? A bus timetable, perhaps, or the TechCommNZ subscription rates? Chances are, you’d have looked at a table. How should technical communicators decide when to use one?