Writing using plain English

Writing for a global audience can be daunting, but by using plain English, you can make sure nothing gets lost in translation. The growth we’re experiencing means we need to be able to communicate with people from all over the world, so it’s a big focus for us.

Xero's global audience

 

So what exactly is plain English? The Plain English Campaign defines it as ‘Writing that the intended audience can understand and act on the first time they read it.’

Plain English also means cutting out jargon and avoiding slang and unfamiliar phrases or words. Clarity is key. What is understood in New Zealand is not necessarily understood in the United States. For example, in New Zealand we use the term ‘fortnight’ to describe a frequency of every two weeks. But we know that in the United States and Canada this is not a familiar word.

8 ways you can write using plain English principles

  1. Write for the reader, not the writer.
  2. Use simple, familiar vocabulary and plain English.
  3. Use correct grammar, spelling and punctuation.
  4. Structure content in a logical way. The top of the page is the most important.
  5. Be concise. Studies show less is more when it comes to words on a website.
  6. Use positive language – it’s shorter and clearer.
  7. Get personal. Use a conversational tone and the word ‘you’.
  8. Use easy-to-read design. If it looks good, people are more likely to read it.

How we keep you in mind when we write

Let’s look at how we apply plain English principles to help.xero.com.

The phrase ‘Content is King’ is one that Xero’s technical writers understand well. If you’ve ever visited help.xero.com, you’ll know there’s a wealth of content about all things ‘online accounting’. Xero’s Help Centre is heavily read by our customers, with an average of 6,000 hits a day. Have a look.
Check out the Xero Help Centre.

Behind the scenes of all this helpful content, we have a team of five technical writers. They create and maintain everything you see on help.xero.com, including the help tips in Xero.

Xero's technical writers are plain English experts

When our technical writers begin a new piece of content, it starts with you. We put ourselves in your shoes. We test a new feature and keep testing until every base is covered. We distill a complex new feature into bite-size chunks so it’s easy for you to know what to do and how to do it. Descriptive subheadings are great ways to break up a wall of words so you can scan the page.

Your time is valuable and our technical writing team recognise that. Content you can understand the first time is written well. But it takes time to create something simple. As Nathaniel Hawthorne once famously said, “Easy reading is damn hard writing.” We couldn’t agree more.

6 Comments

Dan Fairbairn
July 7, 2013 at 10:32 am

Great article, reminds me of the famous quote from Blaise Pascal:

“If I had more time, I would write a shorter letter”

Chris Rogan
July 7, 2013 at 11:30 am

Couldn’t agree more, and had never really considered it – I always seem to struggle with this on website content writing and find that blogging and writing in a local, chatty tone far easier!

Janet Patton
July 7, 2013 at 11:07 pm

Best written technical instructions read to date.
This includes simple short videos, colours, font size and layout on your website.
The instructions are clear, simple and concise.
You have raised the benchmark.

Scott
July 7, 2013 at 6:48 am

The help content supporting Xero rocks! You can tell instantly you guys (and girls) care about what you write and how you write it! Not so easy when your demystifying a stuffy topic like accountancy.

Angela
July 7, 2013 at 1:48 pm

Have been using Xero help centre all the time, easy to follow up, clear and precise instructions given.

Tamyka
December 12, 2013 at 4:02 pm

These principles are excellent, and they reflect how I try to write help pages—especially using the word ‘you’. My new documentation test is asking myself, ‘Would Xero let me post this?’

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

Xero scoops Company of the Year at annual Hi-Tech Awards

I’m proud to announce that on Friday night, Xero was awarded Hi-Tech Company of the Year at the annual Hi-Tech Awards gala dinner. The event was attended by more than 700 guests and held at TSB Arena in Wellington, New Zealand. Xero took out tough competition from other finalists in the category, including ARANZ Geo, Serko and ...

Xero ranked #1 Forbes Most Innovative Growth Company 2015

We’re extremely proud to announce that once again Xero has placed top on the Forbes 100 Most Innovative Growth Companies list. This is our second straight year in the number one spot. The Forbes list recognises firms that investors expect to be innovative both now and in the future. It’s wonderful for Xero’s current innovation ...