Skip to content

Commit

Permalink
Release 7.1.0 wcag updates (#2056)
Browse files Browse the repository at this point in the history
* Update WCAG 2.2 content

* tweak homepage whats new and wcag cta link

* test commit

* undo test commit

* Make minor tweaks after 2i

* Tweak index page message

* bump frontend to 9.0.1

* Add redirect to app router

* update package number

---------

Co-authored-by: Sara Wilcox <[email protected]>
Co-authored-by: roshaanbajwa <[email protected]>
  • Loading branch information
3 people authored Oct 15, 2024
1 parent 0d3e1bc commit 8ca052a
Show file tree
Hide file tree
Showing 18 changed files with 98 additions and 86 deletions.
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# NHS digital service manual Changelog

## 7.1.0 - 15 October 2024

:new: **New features**
- Update accessibility guidance to say that WCAG 2.2 includes WCAG 2.1 and teams are now monitored to WCAG 2.2

## 7.0.0 - 19 September 2024

:new: **New features**
Expand Down
6 changes: 6 additions & 0 deletions app.js
Original file line number Diff line number Diff line change
Expand Up @@ -180,6 +180,12 @@ app.get('/service-standard/:page', (req, res) => {
res.redirect(301, `/standards-and-technology/service-standard-points/${req.params.page}`);
});

// Redirects for accessibility URLs

app.get('/accessibility/new-accessibility-requirements-wcag-2-2', (req, res) => {
res.redirect('/accessibility/new-criteria-in-wcag-2-2');
});

// REDIRECT STOPS HERE

app.get('/content/health-literacy/use-a-readability-tool-to-prioritise-content', (req, res) => {
Expand Down
4 changes: 2 additions & 2 deletions app/views/accessibility/content.njk
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
{% set subSection = "Accessibility" %}
{% set pageDescription = "What content designers, writers and editors need to do to make digital services accessible." %}
{% set theme = "Accessibility guidance for:" %}
{% set dateUpdated = "September 2024" %}
{% set dateUpdated = "October 2024" %}
{% set backlog_issue_id = "347" %}

{% extends "includes/app-layout.njk" %}
Expand All @@ -16,7 +16,7 @@

<p><a href="https://nhsdigital.github.io/accessibility-checklist/">Use the NHS accessibility checklist</a> for:</p>
<ul>
<li>a fuller list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>a full list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>some success criteria and best practice for level AAA</li>
</ul>

Expand Down
4 changes: 2 additions & 2 deletions app/views/accessibility/design.njk
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
{% set subSection = "Accessibility" %}
{% set pageDescription = "What graphic and interaction designers need to do to make digital services accessible." %}
{% set theme = "Accessibility guidance for:" %}
{% set dateUpdated = "September 2024" %}
{% set dateUpdated = "October 2024" %}
{% set backlog_issue_id = "349" %}

{% extends "includes/app-layout.njk" %}
Expand All @@ -16,7 +16,7 @@

<p><a href="https://nhsdigital.github.io/accessibility-checklist/">Use the NHS accessibility checklist</a> for:</p>
<ul>
<li>a fuller list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>a full list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>some success criteria and best practice for level AAA</li>
</ul>

Expand Down
4 changes: 2 additions & 2 deletions app/views/accessibility/development.njk
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
{% set subSection = "Accessibility" %}
{% set pageDescription = "What developers need to do to make digital services accessible." %}
{% set theme = "Accessibility guidance for:" %}
{% set dateUpdated = "April 2024" %}
{% set dateUpdated = "October 2024" %}
{% set backlog_issue_id = "348" %}

{% extends "includes/app-layout.njk" %}
Expand All @@ -16,7 +16,7 @@

<p><a href="https://nhsdigital.github.io/accessibility-checklist/">Use the NHS accessibility checklist</a> for:</p>
<ul>
<li>a fuller list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>a full list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>some success criteria and best practice for level AAA</li>
</ul>

Expand Down
5 changes: 3 additions & 2 deletions app/views/accessibility/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,9 @@
<p>Everyone who works on NHS digital services has a role to play in making them accessible and inclusive.</p>

<h2>Make sure your service meets Web Content Accessibility Guidelines (WCAG) 2.2</h2>
<p>The service manual has been updated to meet WCAG 2.2. <a href="/accessibility/new-accessibility-requirements-wcag-2-2">Find out more about the new requirements</a>.</p>
<p>Teams should comply now to make sure products and services are ready by October 2024. This is when the Government Digital Service, Department of Health and Social Care and NHS England will start monitoring accessibility according to WCAG 2.2.</p>
<p>The service manual is up to date with WCAG 2.2.</p>
<p><a href="/accessibility/new-criteria-in-wcag-2-2">Find out more about the new criteria that WCAG 2.2 introduced</a>.</p>
<p>The Government Digital Service, Department of Health and Social Care and NHS England are now monitoring accessibility to WCAG 2.2.</p>



Expand Down
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
{% set pageTitle = "New accessibility requirements: WCAG 2.2" %}
{% set pageTitle = "New criteria in WCAG 2.2" %}
{% set pageSection = "Accessibility" %}
{% set subSection = "Accessibility" %}
{% set pageDescription = "Your service must meet these requirements." %}
{% set pageDescription = "Your service must meet WCAG 2.2." %}
{% set theme = "Everyone needs to know" %}
{% set dateUpdated = "April 2024" %}
{% set dateUpdated = "October 2024" %}
{% set backlog_issue_id = "512" %}

{% extends "includes/app-layout.njk" %}
Expand All @@ -14,9 +14,10 @@

{% block bodyContent %}

<p>The Web Content Accessibility Guidelines, known as WCAG, have been updated to version 2.2. As a public sector organisation, by law we must meet these guidelines to level AA for all patient and staff-facing services.</p>
<p>The Web Content Accessibility Guidelines, known as WCAG, have been updated to version 2.2, which includes all the success criteria of WCAG 2.1 plus 9 new criteria. As a public sector organisation, by law you must meet the guidelines to level AA for all patient and staff facing services.</p>

<h2>What you need to do</h3>
<p>To get from WCAG 2.1 to WCAG 2.2, follow these steps.</p>

<ol>
<li>Read this page to understand the new criteria you must comply with.</li>
Expand All @@ -25,15 +26,25 @@
<li>Plan and implement your updates.</li>
</ol>

<p>The Government Digital Service, Department of Health and Social Care and NHS England will start monitoring accessibility to WCAG 2.2 from October&nbsp;2024.</p>
<p>The Government Digital Service, Department of Health and Social Care and NHS England are now monitoring accessibility to WCAG 2.2.</p>

<h2 id="new-criteria-in-wcag-2-2">The new criteria</h2>
<p>Use the <a href="https://nhsdigital.github.io/accessibility-checklist/">NHS accessibility checklist</a> for:</p>
<ul>
<li>a full list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>some success criteria and best practice for level AAA</li>
</ul>

<h2 id="extra-criteria">The extra criteria</h2>
<p>
<strong class="nhsuk-tag">
WCAG 2.2
</strong>
</p>
<p>The update adds 9 new success criteria for improving web accessibility. 6 of the new criteria are graded at the A and AA level, which means they're a requirement for websites and mobile apps in the NHS.</p>
<p>WCAG 2.2 includes the WCAG 2.1 criteria, plus 9 new criteria. The 9 new criteria are made up of:</p>
<ul>
<li>6 at A and AA level, which means they're a requirement for NHS websites and mobile apps</li>
<li>3 at AAA</li>
</ul>

<p>These are the 6 new criteria you'll need to meet, as a minimum.</p>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,11 @@
WCAG 2.2
</strong>
</p>
<p>The Web Content Accessibility Guidelines (WCAG) 2.2 add 9 new "success criteria" for improving web accessibility. 6 of the new criteria are graded at the A and AA level, which means they're a requirement for websites and mobile apps in the NHS. <a href="/accessibility/new-accessibility-requirements-wcag-2-2">Learn more about the WCAG 2.2 new accessibility requirements and criteria.</a></p>
<p>See the full list of <a href="/design-system">design system changes to meet the requirements</a>.</p>
<p>The Web Content Accessibility Guidelines (known as WCAG) have been updated to version 2.2, which includes all the success criteria of WCAG 2.1, plus 9 new criteria.</p>
<p>The 9 new criteria are made up of:</p>
<ul>
<li>6 at A and AA level, which means they're a requirement for NHS websites and mobile apps</li>
<li>3 at AAA</li>
</ul>
<p><a href="/accessibility/new-criteria-in-wcag-2-2">Learn more about the new criteria that WCAG 2.2 introduced.</a></p>
<p>The <a href="https://nhsdigital.github.io/accessibility-checklist/">NHS accessibility checklist</a> will help you meet WCAG 2.2.</p>
2 changes: 1 addition & 1 deletion app/views/accessibility/product-and-delivery.njk
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
{% set subSection = "Accessibility" %}
{% set pageDescription = "What product and delivery managers need to do to make digital services accessible." %}
{% set theme = "Accessibility guidance for:" %}
{% set dateUpdated = "April 2024" %}
{% set dateUpdated = "October 2024" %}
{% set backlog_issue_id = "345" %}

{% extends "includes/app-layout.njk" %}
Expand Down
4 changes: 2 additions & 2 deletions app/views/accessibility/testing.njk
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
{% set subSection = "Accessibility" %}
{% set pageDescription = "What testers and quality assurers need to do to make digital services accessible." %}
{% set theme = "Accessibility guidance for:" %}
{% set dateUpdated = "September 2024" %}
{% set dateUpdated = "October 2024" %}
{% set backlog_issue_id = "350" %}

{% extends "includes/app-layout.njk" %}
Expand All @@ -16,7 +16,7 @@

<p><a href="https://nhsdigital.github.io/accessibility-checklist/">Use the NHS accessibility checklist</a> for:</p>
<ul>
<li>a fuller list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>a full list of WCAG 2.2 success criteria and guidance for levels A and AA</li>
<li>some success criteria and best practice for level AAA</li>
</ul>

Expand Down
4 changes: 2 additions & 2 deletions app/views/design-system/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@

<p>Use these design styles, components and patterns to quickly make prototypes or build a live service. The examples come with code to make it easy for you to use them in your project.</p>

<h2 id="wcag-2-2-updates">Changes to meet new accessibility requirements</h2>
<h2 id="wcag-2-2-criteria">Changes to meet new accessibility criteria</h2>
<p>
<strong class="nhsuk-tag">
WCAG 2.2
</strong>
</p>
<p>We've added new guidance to meet WCAG 2.2 level AA. <a href="/accessibility/new-accessibility-requirements-wcag-2-2">Learn about the new WCAG 2.2 accessibility requirements.</a></p>
<p>We've added new guidance to meet WCAG 2.2 level AA. <a href="/accessibility/new-criteria-in-wcag-2-2">Learn about the new criteria in WCAG 2.2.</a></p>

<h3>Updates to our components</h3>
<p>No changes to design or code, but you must check the updated guidance to understand whether your service needs updating.</p>
Expand Down
2 changes: 1 addition & 1 deletion app/views/includes/_side-nav.njk
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
{ title: "What all NHS services need to do about accessibility", url: "/accessibility/what-all-NHS-services-need-to-do" },
{ title: "How to make digital services accessible", url: "/accessibility/how-to-make-digital-services-accessible" },
{ title: "Getting started with accessibility", url: "/accessibility/getting-started" },
{ title: "New accessibility requirements: WCAG 2.2", url: "/accessibility/new-accessibility-requirements-wcag-2-2" },
{ title: "New criteria in WCAG 2.2", url: "/accessibility/new-criteria-in-wcag-2-2" },
{ title: "Download accessibility posters", url: "/accessibility/download-accessibility-posters" }
] %}

Expand Down
4 changes: 2 additions & 2 deletions 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">Minor changes to typography. Also content guide updates.</p>
<p class="nhsuk-card__description">Minor changes to <a href="/accessibility">accessibility guidance</a></p>
</div>
</div>
</div>
Expand All @@ -39,7 +39,7 @@
<strong class="nhsuk-tag nhsuk-u-margin-bottom-0 nhsuk-u-margin-right-3">
WCAG 2.2
</strong>
<h2 class="nhsuk-card__heading nhsuk-heading-xs nhsuk-u-margin-bottom-0 nhsuk-u-display-inline-block nhsuk-u-font-weight-normal"><a href="/accessibility/new-accessibility-requirements-wcag-2-2">Check your service meets the new accessibility requirements</a></h2>
<h2 class="nhsuk-card__heading nhsuk-heading-xs nhsuk-u-margin-bottom-0 nhsuk-u-display-inline-block nhsuk-u-font-weight-normal"><a href="/accessibility/new-criteria-in-wcag-2-2">Check your service meets the new accessibility requirements</a></h2>
</div>
</div>
</li>
Expand Down
4 changes: 2 additions & 2 deletions app/views/site-map.njk
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{% set pageTitle = "Site map" %}
{% set pageDescription = "A list of pages on this website - with links" %}
{% set hideDescription = true %}
{% set dateUpdated = "March 2024" %}
{% set dateUpdated = "October 2024" %}

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

Expand All @@ -15,7 +15,7 @@
<li><a href="/accessibility/what-all-NHS-services-need-to-do">What all NHS services need to do about accessibility</a></li>
<li><a href="/accessibility/how-to-make-digital-services-accessible">How to make digital services accessible</a></li>
<li><a href="/accessibility/getting-started">Getting started with accessibility</a></li>
<li><a href="/accessibility/new-accessibility-requirements-wcag-2-2">New accessibility requirements: WCAG 2.2</a></li>
<li><a href="/accessibility/new-criteria-in-wcag-2-2">New criteria in WCAG 2.2</a></li>
<li><a href="/accessibility/download-accessibility-posters">Download accessibility posters</a></li>
<li><a href="/accessibility/product-and-delivery">Product and delivery</a></li>
<li><a href="/accessibility/user-research">User research</a></li>
Expand Down
60 changes: 10 additions & 50 deletions app/views/whats-new/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@

<h2>Latest updates</h2>

<h3>September 2024</h3>
<h3>October 2024</h3>
<table class="nhsuk-table">
<caption class="nhsuk-table__caption nhsuk-u-visually-hidden">Updates to the service manual in September 2024</caption>
<caption class="nhsuk-table__caption nhsuk-u-visually-hidden">Updates to the service manual in October 2024</caption>
<thead class="nhsuk-table__head">
<tr class="nhsuk-table__row">
<th class="nhsuk-table__header" scope="col" style="width: 25%;">Section</th>
Expand All @@ -22,52 +22,11 @@
<tr>
<td class="nhsuk-table__cell">Accessibility guidance</td>
<td class="nhsuk-table__cell">
<p>Updated <a href="/accessibility/content#write-good-link-and-form-control-names">link section</a> to recommend avoiding "see"</p>
</td>
</tr>
<tr>
<td class="nhsuk-table__cell">Content guide</td>
<td class="nhsuk-table__cell">
<p>Rewrote our <a href="/content/inclusive-content/age">guidance on age</a> to make it clearer</p>
<p>Added <a href="/content/a-to-z-of-nhs-health-writing#Downs-syndrome">Down's syndrome</a>, <a href="/content/a-to-z-of-nhs-health-writing#fit-note">fit note</a> and <a href="/content/a-to-z-of-nhs-health-writing#period-products">period products</a> to the A to Z of NHS health writing</p>
<p>Updated <a href="/content/a-to-z-of-nhs-health-writing#fetus">fetus</a>, <a href="/content/a-to-z-of-nhs-health-writing#microgram">microgram</a> and <a href="/content/a-to-z-of-nhs-health-writing#NHS">NHS</a> in the A to Z</p>
<p>Updated <a href="/content/links">links guidance</a> to recommend avoiding "see"</p>
<p>Updated section on <a href="/content/formatting-and-punctuation#capitalisation">capitalisation</a> to mention geographical names</p>
</td>
</tr>
<tr>
<td class="nhsuk-table__cell">Design system</td>
<td class="nhsuk-table__cell">
<p>Made minor changes to <a href="/design-system/styles/typography">typography section</a>:</p>
<ul>
<li>updated guidance on heading sizes</li>
<li>increased large and medium heading size on desktop and mobile</li>
<li>tweaked line-heights for headings</li>
<li>reduced heading captions sizes</li>
<li>tweaked the typography print styles</li>
</ul>
<p>Tweaked the spacing around the <a href="/design-system/components/breadcrumbs">breadcrumbs</a> and <a href="/design-system/components/back-link">back link</a>, with a recommendation to put back link top of page</p>
<p>Updated <a href="/design-system/styles/page-template">page template</a> guidance and examples:</p>
<ul>
<li>new breadcrumbs position within content page template</li>
<li>added guidance on heading sizes for content pages</li>
<li>updated the <a href="/design-system/styles/page-template#options">Options</a> table</li>
</ul>
<p>Added <a href="/design-system/components/table">table</a> caption size classes</p>

</td>
</tr>
<tr>
<td class="nhsuk-table__cell">NHS service standard</td>
<td class="nhsuk-table__cell">
<p>Updated <a href="/standards-and-technology/about-the-service-standard">About the NHS service standard</a></p>
</td>
</tr>
<tr>
<td class="nhsuk-table__cell">Other</td>
<td class="nhsuk-table__cell">
<p>Updated the <a href="/service-manual-team">service manual team page</a></p>
<p>Updated service manual team email address on <a href="/get-in-touch">Get in touch</a> and other pages</p>
<p>Updated <a href="/accessibility">Accessibility guidance</a> to make it clear that:</p>
<ul>
<li>the Web Content Accessibility Guidelines (WCAG) 2.2 include WCAG 2.1</li>
<li>teams are now monitored to WCAG 2.2</li>
</ul>
</td>
</tr>
</tbody>
Expand Down Expand Up @@ -106,7 +65,7 @@

<p><a href="/whats-new/blog-posts">See all blog posts</a></p>

<h2>Latest show and tell</h2>
<!--<h2>Latest show and tell</h2>
<div class="nhsuk-grid-row nhsuk-card-group">
<div class="nhsuk-grid-column-full nhsuk-card-group__item">
<div class="nhsuk-card">
Expand All @@ -121,8 +80,9 @@
</div>
</div>
</div>
</div>
<p><a href="/whats-new/show-and-tells">See all show and tells</a></p>
<p><a href="/whats-new/show-and-tells">See all show and tells</a></p>-->

{% endblock %}
25 changes: 24 additions & 1 deletion app/views/whats-new/updates.njk
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,29 @@

{% block bodyContent %}

<h2>October 2024</h2>
<table class="nhsuk-table">
<caption class="nhsuk-table__caption nhsuk-u-visually-hidden">Updates to the service manual in October 2024</caption>
<thead class="nhsuk-table__head">
<tr class="nhsuk-table__row">
<th class="nhsuk-table__header" scope="col" style="width: 25%;">Section</th>
<th class="nhsuk-table__header" scope="col">Update</th>
</tr>
</thead>
<tbody class="nhsuk-table__body">
<tr>
<td class="nhsuk-table__cell">Accessibility guidance</td>
<td class="nhsuk-table__cell">
<p>Updated <a href="/accessibility">Accessibility guidance</a> to make it clear that:</p>
<ul>
<li>the Web Content Accessibility Guidelines (WCAG) 2.2 include WCAG 2.1</li>
<li>teams are now monitored to WCAG 2.2</li>
</ul>
</td>
</tr>
</tbody>
</table>

<h2>September 2024</h2>
<table class="nhsuk-table">
<caption class="nhsuk-table__caption nhsuk-u-visually-hidden">Updates to the service manual in September 2024</caption>
Expand Down Expand Up @@ -144,7 +167,7 @@
<tr>
<td class="nhsuk-table__cell">Accessibility guidance</td>
<td class="nhsuk-table__cell">
<p>Added <a href="/accessibility/new-accessibility-requirements-wcag-2-2">new accessibility requirements: WCAG 2.2</a></p>
<p>Added <a href="/accessibility/new-criteria-in-wcag-2-2">new accessibility requirements: WCAG 2.2</a></p>
<p>Added sections on making sure your service meets WCAG 2.2 for: <a href="/accessibility/product-and-delivery">Product and delivery</a> and <a href="/accessibility/design">Design</a>, <a href="/accessibility/development">Development</a> and <a href="/accessibility/testing">Testing</a></p>
</td>
</tr>
Expand Down
Loading

0 comments on commit 8ca052a

Please sign in to comment.