How to make UX writing a thing in your org

andy healey
UX Collective
Published in
8 min readMay 8, 2017

The role of UX Writer is trending right now, with big organizations such as Google and Dropbox actively recruiting. A few weeks ago Kristina Bjoran wrote a great article on How to Break into UX Writing where she identified that to land one of these roles you’re going to need to show that you’re more than just a pretty writer, and have UX design right at the top of your “Key Skills”.

UX writing is a still considered a relatively new role, a “unicorn skill”, outside of California at least. I checked LinkedIn for UX Writer roles in the UK - there were exactly zero results.

So chances are that your organization (or ‘company’ if you’re in the UK) hasn’t yet thought about hiring a UX Writer. Sure, you may have a team of UX Designers or Experience Developers, but how many of them are really into honing and crafting words. John Maeda says in his “2017 Design in Tech Report” that:

A lot of times designers don’t know that words are important

Now that’s maybe a little bit harsh. Most designers are massively overstretched and have to prioritize, and words just don’t come that high up the priority list. And this is what provides you with a massive opportunity.

The six degrees of UX writing

Before you get started, it’s worth evaluating what degree of UX writing your organization currently has. On the scale below then chances are that it’ll be somewhere between one and three. When you get involved you should target three and four as to where you can make a short-term noticeable impact. Your longer-term goal should be to reach five, with six as the holy grail.

1. Identify your opportunities

When I joined Alfresco over 4 years ago, there was a small design team, working on multiple products. Their focus was on delivering great new products and features. Of course this is just the same in most other places, and changing a few words is rarely seen as a value add.

One of Alfresco’s products alone contained over 40,000 individual words. A lot of the copy had been written on the fly by developers and there were things that could definitely be changed to improve the user experience:

· There was no consistency

· There were typos

· Some of it didn’t really make sense

But there was no process for making changes and every day more words were being coded that didn’t have any science behind them. There was an open goal for someone to take ownership of the product copy.

2. Start small

The best way to show you can make a difference and grab attention is to attach yourself to a new project for a standalone feature or small product. It’s all about taking baby-steps, you can’t change everything immediately.

Chat with the Product Manager and/or UX Designer and offer to take a look at the copy in your own time. Propose to them that you can help to make a nicer product that’s more likely to be adopted. Show them a couple of examples of what you could improve. Give them some figures to show how words affect user adoption (for example, 80% of people prefer sentences written in clear English, Clarity is King). It’s all about making a better product. Plus less work for them.

No-one’s going to say no to an offer like that right?

3. Short-cuts to validating your words

Most of the time our gut instinct on what reads better is usually correct. If your team are happy with your gut instinct then great, but wouldn’t it be even better to back yourself up with some real data as well? Prove that the words you use are going to improve the user experience.

At this stage you don’t have writing guidelines and you probably don’t have access to a user research team. Remember that this is a stealth start-up project you’re running here. Fast and light.

Fortunately, there’s a lot of people out there who’ve already done the research for you.

Chances are that your test project has design parallels with other products. So look at those products and see what words they use. Take a look at a few writing guidelines such as Google’s and Apple’s to back up your ideas. For each word choice that you make you want to justify why it’s an improvement. That can often be as simple as “this is what Google do”. Check out the John Saito article on how data informs UX writing at Dropbox — Designing words with data for more on this.

Focus on consistency, clarity and simplicity. You can think about a more formalized tone and voice later.

4. Record everything!

A key mistake I made when I first started reviewing and writing copy was not keeping a record of what I’d done. The team I was working with knew I was involved, but you really need some metrics to show the value you’ve added.

To begin with this doesn’t need to be anything too fancy. Just keep a record of the number of lines of existing content that you’ve reviewed, the number of these that you’ve optimized, and the number of lines of new content you’ve created. And get before and after examples. Ideally for everything you change, but certainly get some of your best work for future reference. This serves two purposes:

  1. For your company — showcase your value-add
  2. For yourself — you’re building a portfolio as a UX Writer

If your team is testing with users before you launch then your validation will done for you. If not, then you can run simple A/B tests yourself comparing the original to your optimized version, using online tools such as Validately (which has a free month trial option). Let’s be honest though, that sounds time consuming. So why not just test out your copy with coworkers, or even your family or friends.

5. Double down — users as advocates for change

Having started from an ad-hoc approach, you’ll hopefully have had a visible impact on product development. The products or features you’ve worked on will have clearer, more consistent copy, with a degree of user validation and competitor analysis. Your UX team and developers can appreciate the positive impact your involvement has, and you’ve recorded evidence of the improvements your brought.

Wouldn’t it be great if you also had users on side to support your efforts?

I had some ideas about how to improve our legacy product copy, but felt that to get real support I needed to prove that users felt the same way. So I set up a survey on SurveyMonkey and asked the team at Alfresco to share it with customers, partners, and users. The result was over 200 respondents, giving us lots of insight. The most important response was to the following statement:

My experience could be improved by changing the tone / terminology

There were also well over 100 specific comments such as:

“too technical”

and

“say it like it is, don’t assume you’re dealing with an Alfresco expert”

If you don’t have the means to conduct your own survey then just share these results with your Product Management team. A massive 49% of our users were telling us that by focussing on UX writing we could improve their experience. That’s a pretty compelling case.

6. Formalize processes

You now have solid evidence behind you, and a body of work that demonstrates the impact you can have. Congratulations! You’ve made real and tangible progress towards making UX writing a thing in your org. This is where the real works starts…

a) Create guidelines

Before you begin to formalize processes you need to set a benchmark. The simplest way to do this is to have defined writing guidelines in place. You can either reuse existing ones such as Google’s, or create your own as we did at Alfresco — docs.alfresco.com/writing-for-alfresco.

In defining your tone and voice there’s a huge amount of info out there, but most of the time finding a style equates to keeping things simple, clear, and non-offensive. There’s plenty of research, for example Microsoft’s presentations on “No more robot speak” (Doug Kim, 2014), showing that a clear majority of people (including developers and other “techies”) want the product voice to be clear, non-technical, and not to look like it’s trying too hard. So just focus on these three things:

1. Consistency — Create a pattern of usage to avoid ambiguity

2. Empathy — Understand your users situation and help them

3. Simplicity — “Simplicity is the ultimate sophistication”

When you’re done, share this in a public space and advertise the fact that it’s now available. If possible, get someone senior to endorse it as the new standard to work to.

b) Integrate writing into the design process

This is nominally straightforward, but depending on the size of your org or any internal resistance, may take some time to for a new process to become the norm.

If you have a UX team or product designers then you need to align with their workflow. My experience is based on working in an Agile environment where UX prototypes and flows are created for developers to work from. There are two key factors to instil in your team:

1. The UX team work with you to create any new copy. To begin with this will likely be that they design protocopy, then you discuss the design and user flow with them and optimize the copy. This is the 5th degree of UX writing — if you make it to here then your company is doing UX writing.

2. The developers DO NOT code anything until they know that it has your approval. This will be a gradual process and is about developing their trust. I’ve found though that most developers would always prefer to defer to the “authority” (remember those writing guidelines) rather than making up some words themselves.

Summary

As far back as 1985 the Apple human interface group recognized the importance of UX writing with their motto “A word is worth a thousand pictures”.

30+ years later we’re starting to see this being realized in the role of UX Writer.

If your org currently settles for the 1st or 2nd degree of UX writing then they’re accepting the associated costs in user unhappiness. In today’s highly competitive markets, with everyone looking to disrupt each other, you have to be better than the competition.

You have the opportunity to make a difference. Now’s the time to make UX writing a thing in your org.

Free

Distraction-free reading. No ads.

Organize your knowledge with lists and highlights.

Tell your story. Find your audience.

Membership

Read member-only stories

Support writers you read most

Earn money for your writing

Listen to audio narrations

Read offline with the Medium app

Published in UX Collective

We believe designers are thinkers as much as they are makers. Curated stories on UX, Visual & Product Design. https://linktr.ee/uxc

Responses (8)

What are your thoughts?