...
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 |
---|
Panel | ||||
---|---|---|---|---|
| ||||
Learn more
|
What is a detailed guide?
...
Use this format for content that is regularly updated, for example, if the process to complete a task changes.
A detailed guide:
- usually answers a specific, task-orientated user need
- addresses professionals and practitioners
- is something government has a duty to provide
- is written and updated by agencies and departments themselves
...
For example, guidance for mainstream audiences (citizens and any general audience) is created by the Government Digital Service (GDS) and then fact-checked by the agency.
Examples:
- https://www.gov.uk/guidance/tick-surveillance-scheme
- https://www.gov.uk/guidance/the-uks-exit-from-the-eu-important-information-for-uk-nationals
- https://www.gov.uk/guidance/register-your-clients-trust
Why use the detailed guides format
...
Best practice for detailed guides
...
Titles
You should:
- make titles active (for example, ‘Submit Statutory Declarations’ not ‘Using and submitting Statutory Declarations’)
- use a colon as a separator, if you need one (for example, ‘Breast screening: education and training’ or Brucella: laboratory and clinical services)
...
- 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
...
borderColor | #2F4F4F |
---|---|
bgColor | #FAFEFF |
Learn more
...
- to
...
- them
Tip |
---|
We hope this article was useful. To share this article with a colleague, please send them this link: https://confluence.collab.test-and-trace.nhs.uk/x/vAIYIg You can also return to the home page to browse more articles on knowledge baseKnowledge Base. |