Tone

The tone of our voice should take into consideration the situation in which the text is read. There are many different factors that will determine a tone of voice.

Here are some helpful tips to help you choose an appropriate tone of voice in which to write:

Gain context

Understand who you are writing for. Many different people with many different backgrounds and job titles might read your words. It is imperative that you know who is your audience. Once you’ve done that work, consider the situations that might lead a user to read your text. Your tone should be different when you provide instructions versus when you inform the user of a success. Our application is full of different types of scenarios. Always ensure that you employ the principles of our voice to maintain consistency across scenarios.

Employ empathy

It is one thing to understand who you are writing for and what situation they are in at a given time. It is another thing completely to truly empathize with them. Once you have done the work to understand the user, put yourself in their shoes. This will help you to determine the most effective way to communicate. Passive voice, for example, is only permitted when writing error messages because no one wants to be told that they did something wrong when they troubleshoot an error.

Vary sentence length

In general, shorter sentences are preferred. When a sentence is short and to the point it is easier to understand and easier to translate. That said, one way to engage a reader and to convey tone is to vary sentence length. This helps to imbue personality into your writing. It also helps to avoid a robotic tone in your paragraphs. It is best to include no more than two distinct thoughts in a single sentence. More than two distinct points in a sentence can confuse and often results in a run-on sentence.