Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Referencing sources or documents #530

Open
sarawilcox opened this issue Jul 29, 2024 · 0 comments
Open

Referencing sources or documents #530

sarawilcox opened this issue Jul 29, 2024 · 0 comments
Labels
content Goes into the 'Content' section of the service manual

Comments

@sarawilcox
Copy link
Contributor

sarawilcox commented Jul 29, 2024

We do not recommend referencing sources in public-facing content. We have not seen a user need for references. Including them may cause confusion or get in the way of users navigating and understanding the information on the page.

References may be needed in professional-facing content.

The following guidance is from the NHS Digital style guide.

references to documents

References to documents should be easy to understand by anyone, not just specialists. They should follow the style guide.

When writing a reference:

  • do not use italics
  • use single quotation marks around titles
  • write out abbreviations in full: ‘page’ not ‘p’, ‘Nutrition Journal’ not ‘Nutr J’
  • use plain English. For example, use ‘and others’ not ‘et al’
  • do not use full stops after initials or at the end of the reference

If the reference is available online, make the title a link and include the date you accessed the online version.
For example: ‘Corallo AN and others. ‘A Systematic Review of Medical Practice Variation in OECD Countries’ Health Policy 2014: volume 114, pages 5-14 (viewed on 18 November 2014)’

@sarawilcox sarawilcox changed the title Referencing sources Referencing sources or documents Jul 29, 2024
@sarawilcox sarawilcox added the content Goes into the 'Content' section of the service manual label Jul 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content Goes into the 'Content' section of the service manual
Projects
Development

No branches or pull requests

1 participant