We want to ensure online services are easy to use, intuitive and focused on customer need. To achieve this we have web design principles, web standards for page authors and web standards for developers.
Below you will find some good practice to help you when writing for the web.
We follow gov.uk's writing style guide
- Be concise - make content brief and to the point.
- Meet user needs - publish only what visitors need to know to complete their task.
- Know your audience - their search terms, questions and how they read.
- Don't use FAQs - answer questions in your content.
- Include keywords and meta-description in your content to boost search rankings.
- Use active voice (not passive) - this will help you write concise and clear language.
- Break up text into subject areas with headings and sub-headings.
- Put the most important information first.
- Good content is easy to read - use words that are easy to understand.
Use the index links below to jump to information further down this page:
- Avoid creating unnecessary new pages
- Writing for your audience
- Writing for the web
- Creating and adding documents
- Shortcut URLs
- Contact Web and Digital Services
1. Avoid creating unnecessary new pages
- Is the content needed and will it have an audience? Contact Web and Digital Services for guidance.
- If the information is not specific to Surrey County Council, link out to the information on another reputable website.
- Avoid duplication. Check if the information already exists.
- Consider adding new content to an existing web page or microsite.
- If the new content is one subject or related subjects, try to condense the information to fit on one web page with headings for each new subject area.
2. Writing for your audience
Make sure your page completes the user's journey as follows:
- I have a question/need.
- I have found the right page easily because the page title and description are clear.
- I understand the information on the page.
- I trust the information and can tell it is up-to-date.
- I found my answer/I know what to do next/I feel reassured/I don't need anything else.
Make sure you also:
- write effective and accessible web content that is suitable for a wide audience;
- be as concise and as clear as possible;
- answer all of your customer's most common questions in the body text, avoiding FAQs pages;
- use keywords in your page titles and in your content as your audience will use these to search for your page;
- and add those keywords and a description to the metadata.
3. Writing for the web
- Write from the customer's perspective using active sentences and personal pronouns (I, we, you).
- Write pages in the 'inverted pyramid/front loading style' ie start the page with the most important information.
- Write in Plain English to make sure your page can be understood by an average 14 year old.
- Avoid jargon and unnecessarily complicated words.
- Explain acronyms when you use them with the words spelt out first eg Surrey County Council (SCC).
- Aim to write sentences that are 15 to 20 words and paragraphs that are three to four sentences.
- Use meaningful headings that can be quickly scanned for content and context.
- Follow house style (available on s-net).
- Make sure your web page content is accurate.
- Do not use 'Page under construction', 'content awaited' or similar on a published page.
- Do not publish blank pages as these will be withdrawn immediately.
- Make headings and sub headings short and meaningful.
4. Creating and adding documents
- Documents should always be converted to PDF and meet PDF standards unless you have permission from Web and Digital Services to publish other file types.
- Do not add documents owned by other organisations as they may be copyright protected. Create an external link to the website where they are located and the customer will always have the latest version.
- Prepare your document correctly for the web with the appropriate branding. If you are unsure, please see the publications guidelines (on S-Net) and PDF web standards.
- Always get your document signed off by your Service before publication. Do not publish draft documents.
- Make sure your file size is 1MB or less. If it isn't, contact Web and Digital Services to let us know.
- Decide upon a clear title and a meaningful description for the document.
5. Shortcut URLs
- Decide if you will need a shortcut web address, eg www.surreycc.gov.uk/schoolmeals.
- Check with Web and Digital Services to make sure the shortcut URL address does not already exist and that it meets our web standards.
- For technical reasons, we cannot set up the shortcut until the page it links to has been published.
- Do not publicise the shortcut URL before all of the relevant web pages are published and we have created the shortcut.
6. Contact Web and Digital Services
Please contact Web and Digital Services for further guidance on preparing your content for the web or to discuss your plans and requirements. Tel: 020 8541 8788. Email: email@example.com
Gov.uk's writing style guide can be found on their Content design pages.