When we standardise language and make it reusable and easy to reproduce by nonwriters, it doesn’t mean our products will end up sounding like robots. On the contrary, simple, human, but still professional is easy to copy — with the right guide. That is why we created the Better content style guide.
Before the digital age, only humans used language to communicate. So, when someone — or something, let’s say an interface — addresses us using language, our brain immediately responds to the other party as if they were human (for more see the book The Man Who Lied to His Laptop by Professor Clifford Nass of Stanford University).
Language is what makes interfaces more human-like. Words on the screen engage us, call us to action, and create an emotional connection. But for this magic to happen, the interface needs to conform to some social conventions and most of all feel natural and authentic.
To be able to scale this human connection in digital products, you need a content style guide.
A content style guide is a set of guidelines and rules that bring consistency to your communication. It ensures that regardless of who is writing the content, the company or product will always sound like you.
It might include editorial guidelines for writing articles as well as guidelines for the smallest interface components, such as a button, and everything in between. Because even the most thought-out design is no good if the content is poorly written.
A content style guide shouldn’t be isolated documentation, but rather an integral part of a design system. The benefits of having one are therefore similar to those of a design system. Users will enjoy a higher level of consistency, which builds trust and relationships, while designers, developers, and writers will work faster with more confidence.
For now, we have one UX writer in our design system team, so Better content style guide is built slowly but steadily. We also didn’t start building it from zero. We looked at existing style guides and used that as our base, adapting it along the way.
While we are laying down the ground rules, such as voice and tone, basic grammar, and writing style, we are also tackling content guidelines for components — if we’re already defining what a button looks like, we should also define what that button can say.
Next to the rules we will include lots of examples of dos and don’ts, which are a great learning tool.
The editorial part will be defined in the future together with the marketing team.
We develop complex products, so we don’t need to be cute or engaging in our notifications. However, even though or precisely because of the complexity, we do want to be useful, precise, simple, and human in our communication, not dry and full of technical jargon that complicates things even more.
What guides us in writing the so-called microcopy is knowing that our messages need to be practical, short, direct, understandable at a glance, and enable our users to perform tasks smoothly.
As we now explained why we need the content guide, read our next blog where we will explain why we decided to first create writing guidelines for notifications, what are the components of our content style guide, and how it makes the lives of our users a bit less stressful.
Better is a leading technology company that transforms healthcare organisations with Better Platform, their market-leading open data platform, the Better Meds electronic prescribing and medication administration solution, and Better’s low code Studio, which allows applications to be built rapidly at a fraction of the cost. The company’s solutions are putting organisations in control of their data, workflows, and transformation plans, all with the aim of simplifying the work of care teams and improving lives. In the last three decades, Better has provided solutions to more than 150 clients across 16 countries, and Better Platform securely supports over 22 million patients.