Please follow the comprehensive guidance on web writing provided by gov.uk
Below are a few key pointers and specific examples for jisc.ac.uk.
Help users find what they are looking for
When reading web pages, users scan a page to find what they need.
Help them to do this in the following ways:
- Put the most important information first
- Use headings and sub-headings (keep them brief; avoid abstract puns or repetition)
- Avoid long paragraphs
- Keep sentences short and concise
- Use bulleted lists where appropriate
- Use meaningful links (a clear action or description such as ‘view our staff policy’ is far more accessible than ‘to see our staff policy, click here’)
Use plain English
Write as you would speak. Avoid formal or old-fashioned language. Don’t blind them with jargon and acronyms (see our style guide for acronym use).
Regardless of a user’s assumed level of expertise, you should aim to help them to find the answer as quickly and easily as possible.
Hemingway can help check and transform your content.
Give your title context
Avoid repetitive chapter titles such as ‘make a difference’ – it means nothing on its own. This is particularly relevant for multi-page guides.
Use Jisc style
All Jisc communications should be consistent so it’s important you familiarise yourself with our style guide before starting to write for Jisc.
Introduction to Jisc style
- We use active, not passive voice
- We don’t use capital letters except for names of people, places, organisations and product brands
- We write numbers up to ten in full
If you have any specific queries around best practice when writing for the web, email email@example.com.