Skip to content

Commit

Permalink
Prep misc changes for July release (#1779)
Browse files Browse the repository at this point in the history
* Prep misc changes for July release

* Add blog images to card #1779

* Update misc files - minor changes

* Fix links

* add contact panel to design principles

* add contact panel to design principles

* Amend contact panel and alt text

* Bump package version number

Co-authored-by: Tosin <[email protected]>
Co-authored-by: w@rren <[email protected]>
  • Loading branch information
3 people authored Jul 15, 2022
1 parent 26e106a commit 0c1c8dc
Show file tree
Hide file tree
Showing 17 changed files with 120 additions and 40 deletions.
14 changes: 14 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,19 @@
# NHS digital service manual Changelog

## 5.7.7 - 15 July 2022

:new: **New features**

- Add a new entry for integrated care boards (ICBs), in the A to Z of NHS health content
- Add 2 new blog posts to What's new

:wrench: **Maintenance**

- Remove link from the standard for creating health content and add a sentence
- Remove a date from the design principles
- Replace a link on review date pattern (Reassure users that a page is up to date)
- Remove a link and fix another in skin symptoms guidance

## 5.7.6 - 16 May 2022

:wrench: **Maintenance**
Expand Down
Binary file added app/assets/blog-post-design-system-conor.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added app/assets/blog-post-design-system-dean.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file removed app/assets/blog-post_head-of-design-nhsx.jpg
Binary file not shown.
11 changes: 7 additions & 4 deletions app/views/content/a-to-z-of-nhs-health-writing.njk
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{% set pageTitle = "A to Z of NHS health writing" %}
{% set pageSection = "Content style guide" %}
{% set pageDescription = "Words and phrases we use to make our content about health and the NHS easy to understand." %}
{% set dateUpdated = "February 2022" %}
{% set dateUpdated = "July 2022" %}
{% set backlog_issue_id = "318" %}

{% block extraMeta %}
Expand Down Expand Up @@ -173,7 +173,7 @@
<p>One word.</p>
<h3 id="Black-or-black">Black or black</h3>
<p>Use a capital letter when you're writing about ethnicity or when you're asking users for their ethnic group.</p>
<p>Use lower-case when you're writing about skin colour.</p>
<p>Use lower case when you're writing about skin colour.</p>
<p>Examples:</p>
<ul>
<li>"Black, Asian, African, Black British or Caribbean"</li>
Expand Down Expand Up @@ -249,7 +249,7 @@
<p>Use full name "Creutzfeldt-Jakob disease" when you first mention CJD.</p>
<p>We do not use "mad cow disease" or "BSE".</p>
<h3 id="clinical-commissioning-groups-(CCGs)">clinical commissioning groups (CCGs)</h3>
<p>Lower case, except when you are referring to a particular CCG. For example: Anytown Clinical Commissioning Group.</p>
<p>CCGs were replaced by <a href="#integrated-care-boards-(ICBs)">integrated care boards (ICBs)</a> in July 2022.</p>
<h3 id="clinical-systems">clinical systems</h3>
<p>See <a href="#GP-system-supplier-names-and-patient-facing-services">GP system supplier names and patient-facing services</a>.</p>
<h3 id="condition">condition</h3>
Expand Down Expand Up @@ -516,6 +516,9 @@
<p>You can use "injection" or "jab" for the injection of <a href="#vaccine">vaccine</a>.</p>
<h3 id="inpatient">inpatient</h3>
<p>One word. Like outpatient.</p>
<h3 id="integrated-care-boards-(ICBs)">integrated care boards (ICBs)</h3>
<p>Lower case when spelt out in full, except when you are referring to a particular ICB. For example: Anytown Integrated Care Board.</p>
<p>We treat integrated care systems (ICSs) and integrated care partnerships (ICPs) the same way.</p>
<h3 id="interaction">interaction</h3>
<p>For medicines, we say "it does not mix with". </p>
<a class="nhsuk-back-to-top__link" href="#nhsuk-a-z-list">
Expand Down Expand Up @@ -979,7 +982,7 @@
<p>One word. </p>
<h3 id="White-or-white">White or white</h3>
<p>Use a capital letter when you're writing about ethnicity or when you're asking users for their ethnic group, for example: "people from a White British background".</p>
<p>Use lower-case when you're writing about skin colour.</p>
<p>Use lower case when you're writing about skin colour.</p>
<h3 id="white-skin">white skin</h3>
<p>We talk about skin colour clearly and use terms that are easy to understand, including "white skin". We do not describe white skin as "fair" or "light".</p>
<p>See the guidance on <a href="/content/inclusive-content/skin-symptoms">skin symptoms in the Inclusive content section</a>.</p>
Expand Down
5 changes: 2 additions & 3 deletions app/views/content/inclusive-content/skin-symptoms.njk
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
{% set pageSection = "Content style guide" %}
{% set pageDescription = "Make written content and imagery of skin symptoms inclusive for people with various skin tones and people with sight loss." %}
{% set subSection = "Inclusive content" %}
{% set dateUpdated = "February 2022" %}
{% set dateUpdated = "July 2022" %}
{% set backlog_issue_id = "181" %}

{% extends "includes/app-layout.njk" %}
Expand Down Expand Up @@ -104,8 +104,7 @@
<li><a href="https://www.blackandbrownskin.co.uk/mindthegap">Mind the Gap</a>: UK clinical handbook of signs and symptoms in black and brown skin published in 2020</li>
<li><a href="https://dftbskindeep.com/">Skin Deep</a>: international website with images of skin conditions in children shown on a range of skin tones</li>
<li><a href="https://skinofcolorsociety.org/patient-dermatology-education/">Skin of Color Society: patient dermatology education for patients</a>: US website with information on a range of skin conditions</li>
<li><a href="https://www.bad.org.uk/healthcare-professionals/inclusivity-and-representation/descriptors-in-dermatolog">The British Association of Dermatologists (BAD) and minority ethnic group inclusivity</a>: information on what BAD is doing to improve descriptions of skin symptoms across a range of skin tones</li>
<li><a href="https://www.bad.org.uk/healthcare-professionals/inclusivity-and-representation/erythema-in-skin-of-colour">The British Association of Dermatologists (BAD): statement on describing redness (erythema) in skin of colour</a> (2021)</li>
<li><a href="https://www.bad.org.uk/reviewing-how-we-describe-skin-symptoms-what-the-bad-is-doing/">British Association of Dermatologists: reviewing how we describe skin symptoms</a></li>
<li><a href="https://dermnetnz.org/">DermNet NZ</a>: a free resource on skin conditions, supported by dermatologists on behalf of the New Zealand Dermatological Society</li>
</ul>

Expand Down
6 changes: 3 additions & 3 deletions app/views/content/standard-for-creating-health-content.njk
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{% set pageTitle = "Standard for creating health content" %}
{% set pageSection = "Content style guide" %}
{% set pageDescription = "This standard outlines some essential requirements and best practice guidance for creating high quality health content. It's designed for any organisation that produces health and care information." %}
{% set dateUpdated = "May 2022" %}
{% set dateUpdated = "July 2022" %}
{% set backlog_issue_id = "430" %}

{% extends "includes/app-layout.njk" %}
Expand Down Expand Up @@ -153,9 +153,9 @@
</ul>

<h2>Developing this standard</h2>
<p>This standard, which we've developed with NHS England, replaces <a href="https://www.england.nhs.uk/tis/">the Information Standard (on NHSE website)</a>.</p>
<p>This standard, which we've developed with NHS England, replaces their former assessment and certification scheme known as the Information Standard, which has now closed. </p>
<p>We've carried out user research with a range of NHS organisations and other organisations that create health content. We also consulted the <a href="https://pifonline.org.uk/">Patient Information Forum</a>, a UK organisation that represents health information producers.</p>

<p>We believe information that is clear, accurate, evidence-based, up to date and easy to use allows people, patients and communities to become better informed and more involved in their health and care.</p>
{% endblock %}

{% block asideContent %}
Expand Down
5 changes: 3 additions & 2 deletions app/views/design-system/design-principles.njk
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,8 @@
{% set pageSection = "Design system" %}
{% set subSection = "Design system" %}
{% set theme = "Principles" %}
{% set dateUpdated = "August 2018" %}
{% set dateUpdated = "July 2022" %}
{% set backlog_issue_id = "442" %}

{% extends "includes/app-layout.njk" %}

Expand All @@ -13,7 +14,7 @@

{% block bodyContent %}

<p>They're inspired by the <a href="https://www.gov.uk/government/publications/the-nhs-constitution-for-england/the-nhs-constitution-for-england">NHS Constitution</a> that's steered the NHS for 70 years.</p>
<p>They're inspired by the <a href="https://www.gov.uk/government/publications/the-nhs-constitution-for-england/the-nhs-constitution-for-england">NHS Constitution</a>.</p>

<p><a href="/assets/nhs-design-principles.pdf">Download design principles poster (PDF, 177KB)</a></p>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
{% set pageSection = "Design system" %}
{% set subSection = "Patterns" %}
{% set theme = "Tasks" %}
{% set dateUpdated = "March 2021" %}
{% set dateUpdated = "July 2022" %}
{% set backlog_issue_id = "31" %}

{% extends "includes/app-layout.njk" %}
Expand Down Expand Up @@ -60,7 +60,7 @@
<p>A page review involves reviewing the whole page to check that it is still accurate and up to date. Whole page reviews should be part of a planned content lifecycle where you create, then update or delete outdated content.</p>
<p>Depending on the content, this may involve checking it with a clinician or other subject matter expert. It also involves, for example, considering any user feedback and checking for broken links or accessibility issues.</p>
<p>For health content, it means reviewing the clinical evidence to make sure that the page is up to date. If there are changes to clinical content, a clinician must sign them off. Read more about <a href="https://service-manual.nhs.uk/service-standard/16-make-your-service-clinically-safe">making your service clinically safe</a>.</p>
<p>The NHS website (nhs.uk) uses review dates on every page of health content as part of the work to meet <a href="https://www.england.nhs.uk/tis/about/the-info-standard/">NHS England's Information Standard</a>, but not on campaign content.</p>
<p>The NHS website (nhs.uk) uses review dates on every page of health content as part of the work to meet <a href="/content/standard-for-creating-health-content">the standard for creating health content</a>, but not on campaign content.</p>

<h2>Research</h3>
<p>We tested review dates on a health information page in summer 2018.</p>
Expand Down
8 changes: 7 additions & 1 deletion app/views/includes/_contact-panel.njk
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<h2 class="nhsuk-u-padding-top-4">{% if subSection === "Styles" %}Have you tested these styles{% endif %}{% if subSection === "Components" %}Have you tested this component{% endif %}{% if subSection === "Patterns" %}Have you tested this pattern{% endif %}{% if pageSection === "Content style guide" or pageSection === "Accessibility" %}Would you like to contribute to this guidance{% endif %}{% if subSection === "NHS service standard" %}Would you like to contribute to the NHS service standard{% endif %}?</h2>
<h2 class="nhsuk-u-padding-top-4">{% if subSection === "Styles" %}Have you tested these styles{% endif %}{% if subSection === "Components" %}Have you tested this component{% endif %}{% if subSection === "Patterns" %}Have you tested this pattern{% endif %}{% if pageSection === "Content style guide" or pageSection === "Accessibility" %}Would you like to contribute to this guidance{% endif %}{% if subSection === "NHS service standard" %}Would you like to contribute to the NHS service standard{% endif %}{% if pageTitle === "Design principles" %}Would you like to contribute to our design principles{% endif %}?</h2>
{% if subSection === "Styles" or subSection === "Components" or subSection === "Patterns" %}

<p>If so, please share your research findings and let us know how it has worked for you. This will help us improve it for everyone.</p>
Expand All @@ -10,6 +10,12 @@
<p>Before you start, you will need a <a href="https://github.com/join?source=login">GitHub account</a>. It's an open forum where we collect feedback.</p>
{% endif %}

{% if pageTitle === "Design principles" %}

<p>Please let us know how the design principles have worked for you and, in particular, if you have research findings to share. This will help us improve the principles for everyone.</p>
<p>Before you start, you will need a <a href="https://github.com/join?source=login">GitHub account</a>. It's an open forum where we collect feedback.</p>
{% endif %}

{% if pageSection === "NHS service standard"%}
<p>Please let us know how this has worked for you and, in particular, if you have gone through a GDS or NHSX service assessment or peer review. This will help us improve it for everyone.</p>
<p>Before you start, you will need a <a href="https://github.com/join?source=login">GitHub account</a>. It's an open forum where we collect feedback.</p>
Expand Down
2 changes: 1 addition & 1 deletion app/views/includes/app-layout.njk
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@

{% block contactPanel %}
{% if hideContact != "true" %}
{% if subSection === "Styles" or subSection === "Components" or subSection === "Patterns" or pageSection === "Content style guide" or pageSection === "Accessibility" or pageSection === "Standards and technology" %}
{% if subSection === "Styles" or subSection === "Components" or subSection === "Patterns" or pageSection === "Content style guide" or pageSection === "Accessibility" or pageSection === "Standards and technology" or pageTitle === "Design principles" %}
{% include "./_contact-panel.njk" %}
{% endif %}
{% else %}
Expand Down
2 changes: 1 addition & 1 deletion app/views/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
<div class="nhsuk-card app-card--transparent nhsuk-u-margin-bottom-0 nhsuk-u-margin-top-0">
<div class="nhsuk-card__content">
<h2 class="nhsuk-card__heading nhsuk-heading-m"><a href="/whats-new">What's new</a></h2>
<p class="nhsuk-card__description">In May 2022 we added a new <a href="/content/standard-for-creating-health-content">standard for creating health content</a></p>
<p class="nhsuk-card__description">In July 2022 we added a new entry for <a href="/content/a-to-z-of-nhs-health-writing#integrated-care-boards-(ICBs)">integrated care boards (ICBs), in the content style guide</a></p>
</div>
</div>
</div>
Expand Down
18 changes: 18 additions & 0 deletions app/views/whats-new/blog-posts.njk
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,24 @@
{% block bodyContent %}
<h2><span class="nhsuk-u-visually-hidden">Blog posts from </span>2022</h2>
<ul class="nhsuk-list nhsuk-list--border nhsuk-u-margin-bottom-5">
<li>
<a href="https://digitalhealth.blog.gov.uk/2022/06/08/why-should-we-build-services-using-a-design-system/" class="nhsuk-heading-m nhsuk-u-margin-bottom-2">Why should we build services using a design system?</a>
<p class="app-meta-data app-meta-data--strong"><span class="nhsuk-u-visually-hidden">Published on: </span>8 June 2022</p>
<p class="app-meta-data nhsuk-u-margin-bottom-2">GOV.UK</p>
<p>Conor Rohan, Assurance Lead, Department of Health and Social Care, explains why we use the NHS.UK and GOV.UK design systems and which one to use.</p>
</li>
<li>
<a href="https://deanvipond.medium.com/a-short-ish-history-of-the-nhs-design-system-part-1-2016-a-website-a-brand-and-a-handful-of-9fdb172e77bb" class="nhsuk-heading-m nhsuk-u-margin-bottom-2">A short(ish) history of the NHS design system, Part 1: 2016 – a website, a brand, and a handful of services</a>
<p class="app-meta-data app-meta-data--strong"><span class="nhsuk-u-visually-hidden">Published on: </span>9 May 2022</p>
<p class="app-meta-data nhsuk-u-margin-bottom-2">Medium</p>
<p>Dean Vipond, previously Lead Designer at NHS Digital, tells the history of the NHS digital design system, in 6 parts.</p>
</li>
<li>
<a href="https://digital.nhs.uk/blog/transformation-blog/2022/reusing-the-right-tools-for-the-job" class="nhsuk-heading-m nhsuk-u-margin-bottom-2">(Re)using the right tools for the job</a>
<p class="app-meta-data app-meta-data--strong"><span class="nhsuk-u-visually-hidden">Published on: </span>7 April 2022</p>
<p class="app-meta-data nhsuk-u-margin-bottom-2">NHS Digital Transformation blog</p>
<p>Shan Rahulan, Director of Platforms – Core Services, argues that we should not try to reinvent the wheel every time we build a product.</p>
</li>
<li>
<a href="https://digital.nhs.uk/blog/design-matters/2022/how-a-20-year-old-standard-is-still-relevant-today" class="nhsuk-heading-m nhsuk-u-margin-bottom-2">How a 20-year-old standard is still relevant today</a>
<p class="app-meta-data app-meta-data--strong"><span class="nhsuk-u-visually-hidden">Published on: </span>8 March 2022</p>
Expand Down
Loading

0 comments on commit 0c1c8dc

Please sign in to comment.