Skip to Content

Clear Language Club

Posts on page 2

Writing NHS messages Link post

I'm almost 6 months into my first contract with NHS England. It's been great to see the constant activity to try and improve content guidance for people working across various digital services.

I want to point you at these new guidelines on writing NHS messages, which are useful for anyone who writes healthcare content. It covers emails, text messages and paper letters, and includes examples of each.

Fancy some further reading? Here's some GOV.UK advice on sending emails and text messages. And if you work in an area where paper letters are essential, you can learn more about how to write effective letters on GOV.UK too.

Summer hiatus

Notes on a busy few weeks that explain why posting to the blog briefly slowed to a stop.

I'm just writing and publishing this post to note and acknowledge the gap in posting since sharing the last newsletter.

It's all straightforward enough. There are only so many hours in the day and Clear Language club is currently a side project to, you know, my actual paying work.

Things I have had to prioritise include:

All this is to say that perhaps summer was a bad time to launch – or extend, I suppose – a new project. And I am sorry about that.

With both autumn and indeed winter, I'm afraid, on the horizon, the pace of publishing here should pick up. Starting tomorrow.

Co-designing with people around difficult subject areas Link post

I have just started working with the brill Charley Pothecary who is bringing some excellent user research and service design nous to the project. In this post, she shares some good, practical suggestions for running inclusive research sessions. These are especially useful if you often work with people who are vulnerable or who have experienced trauma.

Your documentation is still in your Mum’s filing cabinet Link post

This post by Geri Reid questions the traditional folder-based approach to documentation:

For years we’ve treated documentation like a filing cabinet. Put the thing in the right folder and give it a label. But much as it pains me, people rarely wander through my carefully crafted hierarchy, admiring the taxonomy. They search, skim, follow links. And the second finding information feels like work, they’ve checked out and just asked someone.

I have to say, this was exactly my experience on a recent guidance project. Users would often find the document they wanted and make a direct copy to keep locally. Of course, when guidance was updated, that local copy was soon out of date.

For these users, knowing where to quickly find guidance was important. To heck with the shared folder structure! And for those times where they couldn't find the right guidance document at all, they would simply ask a colleague for the answer.

Needless to say, I learnt a lot from this experience. It's important to organise documents in a clear, sensible way that people can easily navigate. But don't think for a second that users will or want to carefully wander through your folder structure to find what they want.

Giving pages a clear shape by using headings Link post

You may have read plenty of articles that explain why you should use headings in your content. This piece by Steve Barnett comes at it from a more technical standpoint to show how headings give pages a clear shape.

If you don't already know a little code, I really recommend learning the basics of HMTL. It will help you understand how a page is structured in code and improve how you work with a developer. You can work with them to make sure your content is clear and accessible, including your headings.