Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip

You're reading an article from PHE's web content knowledge base - the best place to find answers to your content questions.

To browse more useful articles, visit our home page.


Table of Contents

What

...

is a detailed guide?

Detailed guides tell users the steps they need to take to complete a clearly defined task.

Use this format for content that is regularly updated, for example, if the process to complete a task changes.

...

For example, guidance for mainstream audiences (citizens and any general audience) is created by GDS and then fact-checked by the agency.

 

Examples:

https://www.gov.uk/guidance/tick-surveillance-scheme

...

https://www.gov.uk/guidance/register-your-clients-trust

 

Why

...

use the detailed guides format

Detailed guides are:

  • dynamic, so they don't require a publication attachment
  • easy to update in Whitehall Publisher - no additional publishing requirements
  • accessible - they meet our legal requirements for providing accessible content
  • good for SEO - detailed guides have a prominent place in the GOV.UK architecture

...

Detailed guides are the best solution when you need to:

 

  • explain a task
  • incorporate internal and external links to web pages and collections
  • include links to video and other media
  • include images or infographics

...

  • a policy paper
  • a document collection

 

Best practice for detailed guides

...

  • technical terms in section titles unless unavoidable - and then only if you’ve already explained them
  • ‘introduction’ as your first section – users do not want an introduction, they want the most important information
  • questions in section titles
  • FAQs - you will not need them if your content is concise, well structured and written in plain English
  • ‘we’ - users can arrive at your page from anywhere, so ‘we’ may not be clear to them

...


Panel
borderColor#2F4F4F
bgColor#FAFEFF

Learn more

...