Why a content style guide needs to be part of the design system

Why a content style guide needs to be part of the design system
Thought Leadership
Member News

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.

From robotic to human experience

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.

What is 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.

Date and time are an important part of EHR Systems. Above you can see inconsistencies in how dates were written in our applications. 

Starting small

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.

Instructions for writing clear button labels that reassure the user about the action he is taking.

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.

Complex vs simple

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.

The difference in language when communicating with users. Clear instructions, structure with paragraphs, and a friendly tone provide a better experience for the user. 

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.

Discover more about Better:

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.


Related News

Singapore – Singapore Health Technologies Ecosystem is ECHAlliance Ecosystem of the Month – June

12 Jun 2024
This month we are featuring our Singapore - Singapore Health Technologies Ecosystem as our Ecosystem of the Month.

Continence Thematic Innovation Ecosystem

11 Jun 2024
In celebration of Continence Week, we are excited to announce a collaborative webinar with the WFIPP focusing on our Continence Thematic Innovation Ec...

Presenting Kuopio Health members: ThingLink Oy

10 Jun 2024
ThingLink Oy is a Finnish learning technology company with global operations that develops user-friendly, scalable tools for creating interactive and ...

Presenting Kuopio Health members: Smart Visionary Solutions Oy

10 Jun 2024
Smart Visionary Solutions brings digital solutions to learning.

Presenting Kuopio Health members: Novo Granules Oy

10 Jun 2024
Novo Granules provides new pharmaceutical manufacturing solutions. Novo Granules is a company focused on dry granulation. The company is registered in...

Kuopio Health ecosystem R&D actors in spotlight – UEF SIB Labs

10 Jun 2024
UEF SIB Labs Science – Innovation – Business operates as a part of the Department of Technical Physics at the Faculty of Science, Forestry and Technol...

Become a member

Join ECHAlliance to amplify your organisation’s message, grow your networks, connect with innovators and collaborate globally.
First name *
Last Name *
Email Address *
Country *
Position *
First name *
Last Name *
Email Address *
Country *
Position *