One of the ways we create a consistent and familiar experience for our users is by speaking with a consistent voice throughout our product and content while being aware of our tone.
What’s the difference between voice and tone? Think of it this way: our voice is a personification of who we are. We always have the same voice. Then, our tone changes along dimensions of tone to match a given context and situation.
Our brand has a distinct voice and character. This voice and character is the basis of our writing for all of our digital platforms.
When we write in our shared voice, we are always:
- Be clear and concise
- Avoid jargon, acronyms, and filler words
- Be precise and consistent with terminology so that our meaning is always clear
- Express calm positivity
- Help users solve problems and perform tasks quickly
- Anticipate questions and provide answers ahead of time
- Use the words our customers use
- Speak to, not down or up, to our customers
Note: This section will be evolved as we continue to refine our brand identity.
We can express any given message in wildly different ways by combining voice and tone.
There are four dimensions of tone that we can use to adjust the tone of any given message:
- Funny vs. serious.
- Formal vs. casual.
- Respectful vs. irreverent.
- Enthusiastic vs. matter-of-fact.
Our tone comes through the words we use and how we string them together. Our voice shapes which words are part of our vocabulary, and provides a “range” along these dimensions of tone that will keep our voice consistent even as our tone changes.
The difference between voice and tone and how to use them together is tricky. Here’s a specific non-Sourcegraph example of how voice affects vocabulary, while tone affects specific word choice.
Imagine a voice that is Sage. A phrase varied on the enthusiastic vs. matter-of-fact scale might be written like:
- Enthusiastic: “This is lovely!”
- Matter-of-fact: “This is good.”
In contrast, a voice that is Energetic would sound very different on the same scale:
- Enthusiastic: “This is utterly stupendous!”
- Matter-of-fact: “This is great.”