How to put the customer first in your sentences
by Marcia Riefer Johnston

How to put the customer first in your sentences

Linus Says: We are excited to share this guest blog post by Marcia Riefer Johnston. We love the Write the Docs community and all the wonderful connections that grow from it. This article grew out of an unselected lightning talk that turned into an unconference session that Marcia led at the Write the Docs Conference in Portland in May. Thank you to Marcia for sharing her ideas in the WTD Slack and planting the seeds of connection that grew into this delightful post! 

Your business puts the customer first. Every business makes this claim, of course. But does your company's content—product documentation, blog posts, newsletters, wiki pages, emails, you name it—reflect that commitment? Do your company's writers (that includes everyone) know how to put the customer first in their sentences? 

Before we get down to sentence-level tactics, let's step back and consider the impact of choosing your point of view, in general, in your communication. Take these two photos. The content is the same: a couple of kids playing with blocks. The point of view couldn't be less the same, though. The subject—what the photo is about—is not the same. One photo is about blocks—your company’s blocks, let’s say. The other is about kids—your potential customers’ kids. 

Kids playing with blocks vs blocks being played with by kids
Same content, different subjects. Different viewer experiences.


How do you identify the subject in each photo? As the viewer, you don’t have to give this question a thought; you just know. Toys here, kids there. The photographer thought about it, though. A skilled photographer uses framing, color, camera angle, focal point—the elements of visual grammar—to convey what's important. 

A skilled writer does the same thing using the elements of language grammar.

Make people your subject in more of your sentences.

Whatever you write for your business, unless you have a reason to do otherwise (for example, if you’re writing specifications), make people your grammatical subject. Consider this type of sentence: 


Our gizmo enables customers to do this cool thing.

This product-first structure is so common that you may not think twice about it. Of course you want people to know what your product does. Here’s the thing. Customers want to know not what your product can do for them but what they can do with your product.

To make that shift in your writing, start noticing product-centric sentences. The moment you notice the product in the lead, opportunity jumps out at you. Sentences practically rewrite themselves. 

Take the example sentence. The moment you notice that the subject (gizmo) is a product, the sentence begs you to move the words around, something like what’s shown in Figure 1.

Move the words around so that the customer becomes the subject when you realize the subject is a product.
Figure 1:
Whatever your subject matter, your subject matters.


The original sentence talks about the gizmo. The revised sentence talks about the customer. Same content, different subjects. Different reader experiences.

Watch for these tipoff words: enable, let, allow.

I have a suggestion to help you notice product-centric writing: develop an eye for these three words: enable, let, and allow. Look back at Figure 1, for example. The original gizmo sentence uses the verb enable. Here's a sentence that uses let


Tags let you categorize resources by environment.

How might you revise that sentence to put the customer first? Start by deleting let. Then bump the you to the front. Alternatively, lead with use, an imperative verb, which, by definition, has the implied subject you. Figure 2 shows both possible revisions.

Revising a sentence to put the customer first
Figure 2:
Like enable and allow, let often tips you off to product-centric language.


The following example uses allow


A logical name allows you to refer to a resource in the template.

In this case, after deleting allows, you might make you the subject in a number of ways. Figure 3 shows some options.

Options to make you the subject
Figure 3:
You can put the customer first a number of ways.


For variety, move the subject around. It’s still first structurally.

As shown in the last bullet in Figure 3, putting a person first grammatically—making a person your subject—doesn’t necessarily mean putting the person first in the sentence. See Dick run. See Jane run. See the customer do cool things with your product. Who wants to read sentence after sentence like that? 

Enter the flexibility of the English language. You can slide words around without changing a sentence’s underlying structure. Take a look at the two sentences in Figure 4. Both have the same subject: you. In one case, it comes at the beginning. In the other, it comes in the middle. Basically, the prepositional phrase has scooched from one end to the other. Either way, you would diagram the sentence the same way. The subject always comes first grammatically. That’s the kind of first I’m talking about.

Different ways to put the customer first in your sentence
Figure 4:
Wherever the subject appears in a sentence, it always comes first in the underlying structure.


Know when to keep the tipoff words.

Hold on, you might be thinking. Back up to those three tipoff words: enable, let, and allow. They’re legit. Nothing wrong with them. Look them up in any dictionary.

Right you are. I’m cautioning only against enabling people to do something, allowing people to do something, or letting people do something. If your company has a style guide, chances are it suggests avoiding this type of usage. 

Enable a product feature? No problem. Let something happen? No problem. You might even allow someone access to something; allow makes sense for people when you're talking about permission, as shown in Figure 5. 

Different ways to put the customer first in your sentence
Figure 5:
Enable, let, and allow aren't dirty words.


In short, enable, let, and allow aren't dirty words. Let them catch your eye, and then decide whether to keep them. (If you saw what I did there, you're on your way.)

Another tipoff: passive voice.

Passive voice may also tip you off to sentences that put the customer somewhere other than first. Take this sentence:


These accounts can be transferred to your organization.

How do you know that be transferred is passive voice? If you're a language geek, you analyze the verb structure: be-verb (is) + past participle (transferred).1 Boom. Passive voice. 

Alternatively, add by zombies


These accounts can be transferred to your organization by zombies.

If you can you picture zombies doing the thing, you're looking at passive voice. (Credit for the by-zombies test appears to go to Dr. Rebecca Johnson, who tweeted the idea in 2012.)

Before you can edit a passive-voice sentence, you might have to do some sleuthing. Passive voice notoriously hides who or what is doing the thing (transferring the accounts, in this case). Here’s one possible edit, which is also shown in Figure 6: 


You can transfer these accounts to your organization.

Different ways to put the customer first in your sentence
Figure 6:
Passive voice often alerts you to an opportunity to put the customer first.


You don’t have to convert all passive voice to active. Sometimes the subject needs to be obscured. I mean, sometimes you need to obscure the subject. 

Conclusion

Do you compose your sentences with the care of a photographer composing an image? That's what it takes to put your customer first in your sentences. For starters, look for allow, enable, let, and passive-voice verbs. Remember that people don’t care what your products can do. They care about what they can do with your products.



English has eight be-verbs: am, is, are, was, were, be, being, been. Pay attention to them, and you strengthen your writing in all kinds of ways. To find out how, see my blog post Be and Me, which kicks off with a video of the not-to-be-missed Be-Verb Song courtesy of Benjamin Kjos, who sang it for me after attending my workshop at Confab 2015.


Marcia Riefer Johnston

I've loved tech writing from the time I first heard the words technical and writer together. These days I bring technical and writer together in my job title at Amazon Web Services (AWS), where I get to learn and write about cloud computing. In 2013, I fulfilled a dream by writing my book Word Up! How to Write Powerful Sentences and Paragraphs (And Everything You Build from Them). Two years later, my pocket-sized collection came out: You Can Say That Again: 750 Redundant Phrases to Think Twice About. Occasionally I post on my own blog at Writing.Rocks. I live in Portland, Oregon, where I make things with scrumptious yarn, do New York Times crossword puzzles with my husband (especially the Thursday and Sunday puzzles), and lure in family and friends to play Wingspan and other games.

Got an idea for a post you'd like to read...or write?
We're always looking for guest bloggers.

Learn more

Start building your knowledge base today

  • 30 days free (and easy to extend!)
  • No credit card required
  • Affordable, transparent pricing
  • No cost for readers, only authors

 Start a trial 

Want to see it in action?

Watch a 5-minute video and schedule time to speak with one of our owls.

  Watch demo