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 4, 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 4, 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 4, 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 5, 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 8, 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 11, 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>

Payroll for South Dakota, Wyoming, Washington

Following up on the continued momentum from the last release of New Hampshire — we’re excited to announce Payroll in Xero availability for South Dakota, Wyoming and Washington. Over 100,000 small businesses in South Dakota, Wyoming and Washington employ at least one employee. Xero is truly excited to provide an accounting and payroll solution that ...

The new look Xero Android app

We’re pleased to announce the biggest release since the native version of our Xero Android app. Every pixel of the dated Android 4.x ‘Holo’ look is gone! Xero now follows Google’s ‘Material’ design guidelines. We’ve revisited every single screen with an eye on consistency and #beautiful design. We think you’ll find it a vast improvement. ...