How to create consistent content using the editorial style guide: What we covered in October’s Content Improvement Club
We’ve been refreshing the editorial style guide to make it more useful for colleagues across the University. In October’s Content Improvement Club, we explored why consistency matters, what’s changing and how you can use the guide in your own work.
You can read more about the reasons behind the project in Nick Daniels earlier blog post:
Why we’re refreshing the editorial style guide
Using the editorial style guide to make consistent decisions
The editorial style guide helps us make consistent decisions about how we write and present information. It’s designed to help us create content that’s more accessible, readable and inclusive.
It covers a range of everyday editorial decisions, including:
- when to capitalise something and when not to
- how to spell words that have multiple possible spellings
- how to explain abbreviations and acronyms
Exploring consistency through examples
In the session, we started by looking at some everyday editorial decisions to explore how the style guide can help us create consistent content.
How we write the University’s name
We looked at the different ways we might write the University’s name. It’s surprising how many variations we can come up with for something so familiar.
But using different versions can be confusing, particularly for people who don’t know the University as well as we do. A name is an important part of our identity, so we need a shared approach rather than everyone deciding what feels right.
Luckily, we don’t have to guess. The editorial style guide provides clear guidance (the correct wording is the University of Edinburgh).
University terminology style guide page
![]()
How we write dates
We also looked at some of the smaller editorial decisions we make every day, using dates as an example. We showed four date formats in a poll and asked attendees which they would naturally use when writing University content.
Our options were:
- A) 27/10/2026
- B) 27 October 2026
- C) 27th October 2026
- D) 27th Oct 2026
Looking at the options, we discussed how it’s not that one format is universally right and all the others are wrong. Different formats can be appropriate in different contexts. For University content, though, we’ve agreed to use option B) 27 October 2026. Following the same convention helps us keep our content consistent, wherever it appears.
Dates and days editorial style guide page
Why consistency matters
Having looked at some practical examples, we asked attendees why they thought consistency was important when creating content. Using sticky notes, people shared their ideas. There was a lot of overlap between the reasons they identified and the ones we’d thought about beforehand.
One reason is brand reputation. We want people to recognise us as one University, wherever they come across our content. Using consistent terminology and conventions helps build that recognition and trust.
Consistency also supports readability and accessibility. Familiar, predictable formats make content easier to scan, understand and use.
It contributes to clarity and accuracy, too. Having an agreed approach helps avoid confusion and makes it easier for people to understand the information we’re sharing.
Finally, consistency helps create a joined-up user experience. Whether someone is visiting our website, reading an email or looking at social media, we want their experience of the University to feel connected.
Putting the style guide into practice
The session was a little different from some of our previous Content Improvement Clubs. Rather than spending most of the time presenting guidance, we wanted to give attendees the opportunity to explore the style guide for themselves.
We included two practical activities to help people get familiar with the guide.
Exploring the guide through example pages
We looked at two mocked-up webpages we’d created. Both contained deliberate editorial inconsistencies and mistakes. Attendees explored the guide for themselves, find the relevant sections and use the guidance to identify possible improvements.
They used sticky notes to highlight things they’d spotted and consider what they might change. This included things like flagging unexplained acronyms, link text that needed to be placed on a new line and incorrectly formatted bullet lists.
The first example of a mocked-up page used in the session
Second example of a mocked-up annotated page from the session
This gave everyone a chance to become more familiar with the guide and see how it can support everyday decisions when creating and editing content.
Where should you start with the style guide?
One thing we hear from colleagues is that there’s a lot to remember in the style guide. It can be difficult to keep every convention in mind when you’re busy creating and maintaining content.
Our advice was not to try to remember everything. Instead, we suggested starting with four priority areas:
- Acronyms and abbreviations
- Headings
- Links
- Dates and numbers
These are useful areas to focus on when reviewing your content. It’s also worth asking someone else to read it over. A fresh pair of eyes can often spot inconsistencies or things that you might have missed.
Reviewing our own content with other publishers
For our second activity, we used these four priority areas as a starting point. Attendees worked in breakout rooms to look at content from their own websites. People took turns sharing their screens and reviewing each other’s content.
The breakout rooms generated some interesting discussions about the practical challenges of applying editorial guidance. For example, we talked about using links within bullet lists and how much information to divide into separate headings and sections.
These decisions don’t always have a straightforward answer. The important thing is to think about what works best for the people using your content and use the guidance to help inform your decisions.
The activity also gave publishers a chance to get feedback from colleagues they might not usually work alongside and look at their content from a different perspective.
Experimenting with ELM to check content against the style guide
In the session, we also talked briefly about whether ELM (the University of Edinburgh’s AI innovation platform) could help publishers check their content against the editorial style guide.
We haven’t always had reliable results when using ELM for this purpose
As John Wilson explored in his February 2025 blog post, ELM can sometimes identify errors and correctly explain why they don’t follow our guidance, but it can also miss other errors or refer to guidance that doesn’t exist.
Testing ELM’s ability to return useful results and prompts about the editorial style guide
A text-based Markdown version of the style guide is what we’ve tested more recently
We’ve been experimenting with giving ELM the style guide as a text-based Markdown file. This means it can use the actual guidance to check a webpage against, rather than relying on its existing knowledge.
We tried this approach with the two mocked-up pages used in the session. ELM was able to identify the majority of the deliberate inconsistencies, although it still missed some issues, including an example relating to capitalising ‘University’ when referring to the University of Edinburgh.
It’s an interesting experiment, and one we’re continuing to explore. While tools like ELM may be able to help identify potential issues, they should not replace checking the guidance yourself and using your own editorial judgement.
We shared a couple of examples of what we’ve been working on in the guide
It’s been a big undertaking working through each section of the guide. We wanted to give attendees a flavour of the work by looking at a couple of examples.
Bringing University-specific terminology together
We’ve expanded the previous ‘Referring to the University’ page into a broader University terminology page. You can read more about the development of this page in our blog post:
Creating a new style guide page on University terminology
Restructuring the punctuation guidance
We’ve also restructured the punctuation guidance into separate pages.
Punctuation section of the editorial style guide
Previously, much of this guidance was grouped together using accordions. We wanted to move away from this format, which can make content less accessible and harder to navigate.
We’ve reviewed how the different topics are grouped, too. For example, colons and semicolons now sit together, making it easier to compare the two and understand when to use each.
Separating the guidance gives us more flexibility to provide the right level of explanation and include examples where they’re most useful, without simpler guidance getting lost among more detailed sections.
Keeping the guide up to date
We want the editorial style guide to remain a useful, living document rather than something we publish and leave untouched.
Alongside those mentioned in this blog post, some of the changes we’ve made to the guide have been much smaller tweaks or clarifications. We’ve been logging changes on the guide’s updates page, so if you’re interested in following how it continues to develop, you can see what’s changed there.
Updates page (editorial style guide)
How to hear about future Content Improvement Club sessions
We promote these sessions via our mailing list. If you’re interested, please sign up:
Join the UX and Content Design mailing list (University login required)
Suggest a topic for a future session
We’re keen to continue covering topics that colleagues across the University would find useful. It would be really helpful if you could let us know any ideas you have using this form:
Suggest a topic for Content Improvement Club (University login required)
Other training that we offer
More training is listed on the User Experience Service website:
Training | User Experience Service