Creating content for all our users
Anyone can put information online. But we want to do it really well.鈥�
, opting instead to scan pages, picking out words and sentences that interest them, and ignoring the rest.鈥��
At the same time, there are approximately with a variety of needs when it comes to accessing and interacting with online content.鈥��
All audiences should understand our content. This isn鈥檛 鈥榙umbing down鈥�; this is opening up our knowledge for all. As such, the benefits of writing with clarity, brevity and simplicity are easy to see regardless of a visitor鈥檚 circumstances.鈥�
Creating accessible content
You must make sure your content is accessible. 鈥�
As a public sector body, we're to make the content on our website as accessible as possible. This includes . The government checks our content to make sure it complies with the internationally recognised guidelines from the (W3C). 鈥�
Find out more about accessibility or contact beta-content@bath.ac.uk if you have any questions.鈥�
Seven rules for writing for the web鈥�
- Make it brief and to the鈥痯oint.鈥�
- Break鈥痷p text into subheaded鈥痵ections. See our guide to creating headings in Typecase.鈥�
- Use鈥痭umbered and bulleted lists. See our鈥�guide to creating lists in Typecase.
- 鈥楩ront-load鈥� subheadings, titles and bullet points by putting the most important information鈥痜irst. See our guide to writing accessible titles and summaries. 鈥�
- Include鈥痩inks to external sites and relevant鈥痯ages. See our guide to creating links in Typecase.鈥�
- Use鈥痺ords that are easy to鈥痷nderstand.鈥�
- Use鈥痑ctive, not passive, tense. This gives your writing more energy and clarifies who the main actors are in your writing.鈥�
What the user wants matters most鈥�
Users usually only read text if they want information. When you write for the web, start with the same question every time - what does the user want to know?鈥�
Meeting the user need means being:鈥�
- 蝉辫别肠颈蹿颈肠鈥�
- 颈苍蹿辞谤尘补迟颈惫别鈥�
- clear鈥痑nd to the point鈥�
Read our guide to creating user stories for web content.鈥�
Writing for an academic audience鈥�
It is tempting to think that when writing about complex subjects for an academic audience, it isn鈥檛 necessary to use plain English. This isn鈥檛 the case.鈥��
In fact, found that the more educated a person was and the more specialist their knowledge, the more they preferred plain English as it enabled them to understand information quickly.鈥����
If there is a simpler, more direct way to express an idea, use it. Every member of your audience will benefit. 鈥�
Technical terms
Sometimes you may need to use a technical term or an abbreviation. That鈥檚 fine, but if you do, be sure to explain it fully the first time you use it in your content.鈥��
Legal content
Legal content can still be written in plain English. However, if it鈥檚 not, it鈥檚 a good idea to create a plain English summary to accompany it.鈥���
Use plain English
Users don鈥檛 stop understanding text because it鈥檚 written clearly, they understand it more.鈥��
When writing content, avoid formal or long words when easy or short ones will do. Use:
- 鈥榖uy鈥� instead of 鈥榩urchase鈥�
- 鈥榟elp鈥� instead of 鈥榓ssist鈥�
- 鈥榓bout鈥� instead of 鈥榓pproximately鈥�
- 鈥榣ike鈥� instead of 鈥榮uch as鈥�
We also lose the trust of our users if we write 鈥榖uzzwords鈥� and jargon. Often, these words are too general and vague, and can lead to misinterpretation or empty, meaningless text. You can generally get rid of this type of word simply by saying what you are actually doing. Be open and specific.鈥�
Keep your intended audience in mind and write as if you were talking to a single member of it 鈥� with the approachable authority of someone who can and wants to actively help.鈥�
Check the reading level
We recommend using . This free, browser-based app analyses text, giving it a readability grade and highlighting areas for improvement. To make sure your content is written in accessible, plain English, you should aim for a Hemingway readability grade of between six and eight. 鈥�
You can also . This gives you a score for the readability of your document based on .
Read the .
Words to avoid
This list isn鈥檛 exhaustive, it鈥檚 an indicator of the sort of language that confuses users:鈥�
- additional 鈥撯�痷se 'extra'鈥�
- advise鈥�撯�痷se 'tell'鈥�
- 补诲惫补苍肠颈苍驳鈥�
- agenda鈥�(unless it's for a meeting)鈥�
- applicant 鈥撯�痷se 'you'鈥�
- 肠辞尘产补迟迟颈苍驳鈥�
- commit/pledge (be more specific 鈥� you're either doing something or you're not)鈥�
- consequently 鈥撯�痷se 'so'鈥�
- 肠辞耻苍迟别谤颈苍驳鈥�
- deliver鈥�(pizzas, post and services are delivered 鈥� not abstract concepts like 鈥榠mprovements鈥� or 鈥榩riorities鈥�)鈥�
- deploy (unless it's military or software)鈥�
- dialogue (you speak to people)鈥�
- disincentivise (and incentivise)鈥�
- dispatch/despatch 鈥撯�痷se 'send'鈥�
- 别尘辫辞飞别谤鈥�
- ensure鈥�� use 'make鈥痵ure'鈥�
- facilitate鈥�(instead, say something specific about how you are helping)鈥�
- 蹿辞肠耻蝉颈苍驳鈥�
- forward鈥�撯�痷se 'send'鈥�
- foster鈥�(unless it's children)鈥�
- impact (as a verb)鈥�
- 颈苍颈迟颈补迟别鈥�
- key鈥�(unless it unlocks something. A subject/thing isn鈥檛 鈥榢ey鈥� 鈥� it鈥檚 probably 鈥榠mportant鈥�)鈥�
- land (as a verb, unless you are talking about an aircraft)鈥�
- leverage (unless in the financial sense)鈥�
- liaise - use 'meet with', 'to discuss with', 'to work with' (whichever is more descriptive)鈥�
- 辞惫别谤补谤肠丑颈苍驳鈥�
- on鈥痳eceipt 鈥� use 'when we/you鈥痝et'鈥�
- on鈥痳equest 鈥� use 'if you鈥痑sk'鈥�
- particulars鈥�撯�痷se 'details'鈥�
- per鈥痑nnum 鈥� use 'a鈥痽ear'鈥�
- persons鈥�� use 'people'鈥�
- prior鈥痶o 鈥撯�痷se 'before'鈥�
- progress鈥�(as a verb 鈥� what are you actually doing?)鈥�
- promote (unless you are talking about an ad campaign or some other marketing promotion)鈥�
- remittance 鈥撯�痷se 'payment'鈥�
- slimming鈥痙own (processes don鈥檛 diet 鈥� you are probably 'removing x amount of paperwork', or similar)鈥�
- 蝉迟谤别补尘濒颈苍别鈥�
- strengthening鈥�(unless it鈥檚 strengthening bridges or other structures)鈥�
- tackling (unless it's rugby, football or some other sport)鈥�
- transforming (what are you actually doing to change it?)鈥�
- utilise 鈥撯�痷se 'use'鈥�
- whilst鈥�� use 'while'鈥�
Always avoid metaphors and idioms, particularly clich茅d ones, such as:鈥�
- drive (you can only drive vehicles; not schemes or people)鈥�
- drive out (unless it's cattle)鈥�
- going forward (unless you are giving travel directions)鈥�
- in order to (this is superfluous 鈥� don鈥檛 use it)鈥�
- 辞苍别-蝉迟辞辫鈥痵丑辞辫鈥�
- 谤颈苍驳鈥痜别苍肠颈苍驳鈥�
Use the active voice
In the active voice, the subject of the sentence 鈥媝erforms鈥� the action. This sounds more clear, conversational and engaging than the passive voice, for example, 'Professor Walker will deliver a lecture 鈥媜n data modelling'鈥�.鈥�
Try to avoid using words such as 鈥榖y鈥� that may 鈥媠uggest鈥� that you are writing in passive voice, for example, 'the lecture 鈥媜n data modelling will be delivered鈥� by Professor Walker'.鈥�
One exception to this rule is when you want to specifically emphasise the action or impact over the subject 鈥媜f the sentence鈥�, for example, '豆包成人版 is named as one of the world's top 100 'most international' universities'.鈥�