2i checks (#48)

* Finished 2i checking all 'Features' content. Made the following minor edits. Security: - changed double speech marks to single quotation marks - wrote GDPR in full before acronym - added no TOC markdown to stop bullets capitalising - made Virtual Private Clouds lower case - NHS Notify restrict communications - changed to restricts - removed full stop at end of bullet - removed Oxford comma NHS App: - added missing sentence 'When a user selects the banner notification, this opens their message in the NHS App.' (I'd forgotten to add this from the prototype following App colleagues' review) - added 'the' before NHS App to last image caption - changed 'that' to 'who' in 'members of the public who have the NHS App' Text messages: - changed 'a' to 'an' in first image caption Letters: - changed 'two sided letter' to 'double-sided letter' in caption, to match language on other pages - changed 'Page size and layout: A4 portrait (210 x 297mm)' to 'The page size and layout is A4 portrait (210 x 297mm).' - added apostrophe to 'recipient's address' * Further 2i changes detailed below. Security Changed double speech marks to single quotation marks GDPR Added no TOC markdown Made Virtual Private Clouds lower case NHS Notify restrict communications Removed full stop at end of bullet Removed oxford commas Nhs app Added missing sentence 'When a user selects the banner notification, this opens their message in the NHS App.' Added 'the' before NHS App to last image caption Changed 'that' to 'who' in 'members of the public who have the NHS App' Text messages Changed 'a' to 'an' in first image caption Letters Changed 'two sided letter' to 'double-sided letter' in caption, to match language on other pages Changed 'Page size and layout: A4 portrait (210 x 297mm)' to 'The page size and layout is A4 portrait (210 x 297mm).' Added apostrophe to 'recipient's address' Pricing Text messages Added 'accented' before 'characters' in that column of the table at bottom to distinguish it from the table above Changed 'each additional… characters' to 'every additional… characters' Letters Added hyperlink to accessible formats page Made all '+ VAT' instances in the body texts '(plus VAT)' for consistency with other pages Removed hyphen from second 'cross charge' Added some contractions e.g. 'you'll', 'you've' Using NHS Notify MESH Added link to MESH Added onboarding team email Editing and formatting Struggling to get no TOC code to work - needs picking up, chased with devs Added '<code>' to markdown examples, to stop the markdown from rendering and keep the code visible for users to copy Links and URLs Changed 'Scroll down to see a guide to the available Markdown' to 'The formatting guide with the available Markdown is on the right-hand side of the page'. Tell recipients who… We should probably add a heading for 'Return addresses' - didn't want to add this in just yet as it's getting pulled into the automatic TOC for things we can change, making it look like users can change return addresses Added link to ODS portal Accessible formats Added link to letter pricing page Changed 'This is available for NHS App messages, emails, text messages and letters' to 'This is available for all message channels' Made the '4. We’ll check for recipients with access needs' section more concise Letters in other languages Made the 'We'll check for recipients who need letters in other languages' section more concise Delivery times Updated the NHS App section in line with the Figma prototype, which has the latest content requests from App colleagues Minor tweaks to wording - 'because there are privacy issues' > 'because of privacy issues', made 'it is' a contraction Added line breaks in letter section to add more white space * Generally, added the new code Chris identified to stop the automatic table of contents being added Providing NHS numbers Made 'Numbers' lower case in 'NHS numbers' Amended first link to API to open in a new tab Support Added onboarding team email Get started Incorporated the onboarding email into the existing sentence * Removed extra line break in numbered list example.
NHSDigital · Aug 1, 2024 · 8132afa · 8132afa
1 parent d10403e
commit 8132afa
Show file tree

Hide file tree

Showing 24 changed files with 129 additions and 167 deletions.
diff --git a/docs/pages/features/letters.md b/docs/pages/features/letters.md
@@ -15,7 +15,7 @@ You can use NHS Notify to print and bulk send letters to patients and members of
 {% include components/image.html
     src="nhs-notify-letter-two-sides-example.svg"
     alt="An image showing both sides of a letter sent by NHS Notify"
-    caption="An example of a black and white two sided letter sent by NHS Notify."
+    caption="An example of a black and white double-sided letter sent by NHS Notify."
 %}
 
 ## What you need to know
@@ -38,11 +38,11 @@ You might want to understand more about:
 
 To send letters with NHS Notify, your content must meet our letter specification. This is done automatically for you when you create a letter template using NHS Notify.
 
-Page size and layout: A4 portrait (210 x 297mm)
+The page size and layout is A4 portrait (210 x 297mm).
 
 ## Envelopes
 
-NHS Notify uses C5 size envelopes with an address window. This means the A4 letter is folded in half with the recipients address displayed in the address window.
+NHS Notify uses C5 size envelopes with an address window. This means the A4 letter is folded in half with the recipient's address displayed in the address window.
 
 {% include components/image.html
     src="nhs-notify-envelope-example.svg"

diff --git a/docs/pages/features/nhs-app-messages.md b/docs/pages/features/nhs-app-messages.md
@@ -10,7 +10,7 @@ permalink: /features/nhs-app-messages
 section: Message channels
 ---
 
-Send free unlimited messages to patients and members of the public that have the NHS App.
+Send free unlimited messages to patients and members of the public who have the NHS App.
 
 {% include components/image.html
     src="nhs-notify-nhs-app-example-2.svg"
@@ -38,11 +38,13 @@ Recipients can choose if they want to receive notifications in the NHS App or in
 
 Banner notifications are short messages that appear on the lock screen of a recipient’s device. They show the recipient that there is an unopened message waiting in their NHS App inbox.
 
+When a user selects the banner notification, this opens their message in the NHS App.
+
 To protect recipients, banner notifications pushed by the NHS App do not include any of your message content.
 
 {% include components/image.html
     src="nhs-notify-nhs-app-banner-notification.svg"
-    alt="An image of two mobile devices side by side showing an example banner notification for both iPhone and Android devices pushed by the NHS App."
+    alt="An image of 2 mobile devices side by side showing an example banner notification for both iPhone and Android devices pushed by the NHS App."
     caption="An example of a banner notification pushed to an iPhone and an Android device by the NHS App."
 %}
 
@@ -53,5 +55,5 @@ When a recipient receives a NHS App message, a badge notification will appear on
 {% include components/image.html
     src="nhs-notify-nhs-app-badge-notification.svg"
     alt="A screenshot of the NHS App icon with a red badge showing 1 notification."
-    caption="An example of a badge notification pushed by NHS App when a message is sent to a recipient’s NHS App inbox."
+    caption="An example of a badge notification pushed by the NHS App when a message is sent to a recipient’s NHS App inbox."
 %}
diff --git a/docs/pages/features/roadmap.md b/docs/pages/features/roadmap.md
@@ -23,18 +23,18 @@ You can [contact us]({% link pages/support/support.md %}) if you:
 ## Things we're working on now
 
 - Let users provide alternative contact details in certain approved circumstances
-- Standardise letter printing using PDFs
 - Improve onboarding for new users
 - Increase print capacity and resilience by bringing in an additional supplier
 - Let users create and manage their own templates
 - Publish a new website with information about NHS Notify
-- Let users manage their own routing plans
 - Provide real-time message statuses to show whether messages have been successfully delivered
 - Show users which recipients have NHS App accounts and notifications enabled
 - Let users subscribe to more detailed NHS APP message statuses
 
 ## Things we'll do later
 
+- Let users manage their own routing plans
+- Standardise letter printing using PDFs
 - Improve how we validate postal addresses
 - Develop more efficient onboarding processes
 - Provide more granular message statuses for all channels

diff --git a/docs/pages/features/security.md b/docs/pages/features/security.md
@@ -13,45 +13,46 @@ NHS Notify is part of NHS England and is built for the security needs of its org
 
 This means NHS Notify:
 
-- uses the Data Security and Protection Toolkit (DSPT) self-assessment return and holds the status “Standards Met”
-- is a GDPR compliant service
-- aligns to the Information Security Management System standard (ISO 27001:2022)
+- uses the Data Security and Protection Toolkit (DSPT) self-assessment return and holds the status 'Standards Met'
+- is a General Data Protection Regulation (GDPR) compliant service
+- aligns to the information security management system standard (ISO 27001:2022)
 - uses the Cyber Assessment Framework (CAF), developed by the National Cyber Security Centre (NCSC)
-- adheres to the 10 National Data Guardian's Data Security Standards
+- adheres to the 10 National Data Guardian's data security standards
 
 NHS Notify also has approaches for:
 
-- [Network security](#network-security)
-- [Security groups and policies](#security-groups-and-policies)
-- [Secure development practices](#secure-development-practices)
-- [Data protection](#data-protection)
-- [Patch management](#patch-management)
-- [Security monitoring and logging](#security-monitoring-and-logging)
-- [Security configuration](#security-configuration)
-- [Regulatory compliance](#regulatory-compliance)
+<!-- no toc -->
+- [network security](#network-security)
+- [security groups and policies](#security-groups-and-policies)
+- [secure development practices](#secure-development-practices)
+- [data protection](#data-protection)
+- [patch management](#patch-management)
+- [security monitoring and logging](#security-monitoring-and-logging)
+- [security configuration](#security-configuration)
+- [regulatory compliance](#regulatory-compliance)
 
 ## Network security
 
 NHS Notify maintains network security by:
 
-- configure and managing virtual networks securely
-- using firewalls, network security groups, and other tools to control and monitor inbound and outbound traffic
-- implementing Virtual Private Clouds (VPCs) for private network environments
+- configuring and managing virtual networks securely
+- using firewalls, network security groups and other tools to control and monitor inbound and outbound traffic
+- implementing virtual private clouds (VPCs) for private network environments
 - performing intrusion detection and prevention monitoring to identify and respond to potential threats via the Cyber Security Operations Centre (CSOC)
 
 ## Security groups and policies
 
 NHS Notify:
 
 - defines and enforces security groups and policies
-- restrict communications between different components in the cloud environment
+- restricts communications between different components in the cloud environment
 - regularly reviews and updates security group configurations
 
 ## Secure development practices
 
 NHS Notify develops its service securely by:
 
-- following secure coding practices for applications.
+- following secure coding practices for applications
 - conducting regular security assessments, code reviews, and testing
 - implementing continuous integration and continuous deployment (CI/CD) security controls within the pipeline
 
@@ -78,7 +79,7 @@ NHS Notify monitors and logs its security by:
 
 - implementing continuous monitoring for suspicious activities
 - observing and monitoring resources and applications
-- maintaining logs for auditing, analysis, and forensic purposes
+- maintaining logs for auditing, analysis and forensic purposes
 
 ## Security configuration
 

diff --git a/docs/pages/features/text-messages.md b/docs/pages/features/text-messages.md
@@ -14,8 +14,8 @@ Use NHS Notify to bulk send text messages such as invitations, alerts, notificat
 
 {% include components/image.html
     src="nhs-notify-iphone-android-sms-example.svg"
-    alt="An image of two mobile devices side by side showing a received text message, one displayed on iPhone and the other displayed on an Android device."
-    caption="An example of a text message (SMS) sent by NHS Notify to a iPhone or Android mobile device."
+    alt="An image of 2 mobile devices side by side showing a received text message, one displayed on iPhone and the other displayed on an Android device."
+    caption="An example of a text message (SMS) sent by NHS Notify to an iPhone or Android mobile device."
 %}
 
 ## What you need to know

diff --git a/docs/pages/get-started/get-started.md b/docs/pages/get-started/get-started.md
@@ -22,8 +22,6 @@ You might want to learn more about:
 
 ## 2. Get in touch to register your interest
 
-If you think NHS Notify is right for your organisation or service, you can get in touch by emailing our engagement team.
-
-<[email protected]>
+If you think NHS Notify is right for your organisation or service, you can get in touch with our engagement team via <[email protected]>.
 
 We'll contact you within 10 working days to find out more about what your service needs.
diff --git a/docs/pages/pricing/how-to-pay.md b/docs/pages/pricing/how-to-pay.md
@@ -11,7 +11,7 @@ permalink: /pricing/how-to-pay
 
 This page describes how NHS England organisations and services pay for the messages they send using NHS Notify.
 
-If you’re not part of NHS England but will soon be using NHS Notify, we are currently developing another payment process.
+If you’re not part of NHS England but will soon be using NHS Notify, we're currently developing another payment process.
 
 ## Before you start
 
@@ -21,8 +21,8 @@ You must provide your cost centre number before you start sending messages. This
 
 ## Cross charging
 
-NHS Notify checks invoices from its suppliers against your monthly message volumes to see if they are correct. You will soon be able to use our dashboard to track how much you’ve spent.
+NHS Notify checks invoices from its suppliers against your monthly message volumes to see if they're correct. You'll soon be able to use our dashboard to track how much you’ve spent.
 
-We then receipt supplier invoices with the NHS England finance team and cross-charge your service or organisation at the end of the month.
+We then receipt supplier invoices with the NHS England finance team and cross charge your service or organisation at the end of the month.
 
-You will only ever be charged for text messages and letters that you have sent.
+You'll only ever be charged for the text messages and letters that you've sent.
diff --git a/docs/pages/pricing/letters.md b/docs/pages/pricing/letters.md
@@ -30,7 +30,7 @@ Prices include:
 
 You can use a range of accessible formats to send letters to people with accessibility needs.
 
-Learn more about NHS Notify’s accessible letter formats.
+Learn more about NHS Notify’s [accessible letter formats]({% link pages/using-nhs-notify/accessible-formats.md %}).
 
 | Accessible format           | Cost                      |
 | --------------------------- | ------------------------- |
@@ -42,7 +42,7 @@ Learn more about NHS Notify’s accessible letter formats.
 
 You can include an insert with letters to give recipients other information. For example, this could be a leaflet to a related service.
 
-If you include an insert with your letter, you will need to pay an insert fee of up to 1.08 pence + VAT for each letter.
+If you include an insert with your letter, you will need to pay an insert fee of up to 1.08 pence (plus VAT) for each letter.
 
 You can print your inserts elsewhere or use NHS Notify. If you use NHS Notify, you will need to pay the print cost.
 
@@ -54,7 +54,7 @@ You can print your inserts elsewhere or use NHS Notify. If you use NHS Notify, y
 
 ## Returned letter costs
 
-There is an 18 pence charge for each letter you send that is returned. Returned letters are then destroyed for data security, which costs £5.99 + VAT for every 10,000 letters.
+There is an 18 pence charge for each letter you send that is returned. Returned letters are then destroyed for data security, which costs £5.99 (plus VAT) for every 10,000 letters.
 
 Letters are sometimes returned because:
 

diff --git a/docs/pages/pricing/pricing.md b/docs/pages/pricing/pricing.md
@@ -30,7 +30,7 @@ It costs 2.27 pence (plus VAT) for every text message you send.
 
 ## Letters
 
-It costs up to 61p (plus VAT) to send 1 A4 sheet letter with both sides printed using 2nd class postage.
+It costs up to 61p (plus VAT) to send a one-sheet letter with both sides printed using 2nd class postage.
 
 {% include components/action-link.html
     url='/pricing/letters'

diff --git a/docs/pages/pricing/text-messages.md b/docs/pages/pricing/text-messages.md
@@ -11,7 +11,7 @@ permalink: /pricing/text-messages
 
 It costs 2.27 pence (plus VAT) for each text message you send.
 
-You may pay more for each message, if you:
+You may pay more for each message if you:
 
 - send text messages longer than 160 characters
 - use certain signs and symbols
@@ -23,6 +23,7 @@ If a text message is longer than 160 characters (including spaces), it counts as
 
 | Message length       | Charge          |
 | -------------------- | --------------- |
+| Up to 160 characters | 1 text messages |
 | Up to 306 characters | 2 text messages |
 | Up to 459 characters | 3 text messages |
 | Up to 612 characters | 4 text messages |
@@ -31,7 +32,7 @@ If a text message is longer than 160 characters (including spaces), it counts as
 
 ## Signs and symbols
 
-The following signs and symbols count as 2 characters each: []{}^\|~€
+The following signs and symbols count as 2 characters each: []{}^\|~€.
 
 Using them can increase the cost of sending text messages.
 
@@ -43,10 +44,10 @@ The following accented characters do not affect the cost of sending text message
 
 Using other accented characters can increase the cost of sending text messages.
 
-| Message length                | Charge                    |
-| ----------------------------- | ------------------------- |
-| Up to 70 characters           | 2 text messages           |
-| Up to 134 characters          | 3 text messages           |
-| Up to 201 characters          | 4 text messages           |
-| Up to 268 characters          | 5 text messages           |
-| Each additional 67 characters | 1 additional text message |
+| Message length                          | Charge                    |
+| --------------------------------------- | ------------------------- |
+| Up to 70 accented characters            | 1 text messages           |
+| Up to 134 accented characters           | 2 text messages           |
+| Up to 201 accented characters           | 3 text messages           |
+| Up to 268 accented characters           | 4 text messages           |
+| Every additional 67 accented characters | 1 additional text message |
diff --git a/docs/pages/support/support.md b/docs/pages/support/support.md
@@ -27,4 +27,4 @@ If you work in NHS England and want to start using NHS Notify, find out how to [
 
 ## I have questions about NHS Notify
 
-If you work in an NHS England team that’s not currently using NHS Notify and you have further questions, email our engagement team.
+If you work in an NHS England team that’s not currently using NHS Notify and you have further questions, email our engagement team via <[email protected]>.
diff --git a/docs/pages/using-nhs-notify/accessible-formats.md b/docs/pages/using-nhs-notify/accessible-formats.md
@@ -18,11 +18,16 @@ All organisations that provide NHS care or publicly-funded adult social care are
 
 NHS Notify offers the following letter formats so you can reach people with access needs.
 
-| Accessible format    | Description |
-| -------- | ------- |
-| Large print  | Letters that have a larger font than usual. Large print letters typically have a point size of 16 and above.    |
-| Braille | Includes the original letter and a Braille insert. NHS Notify uses the Royal National Institute of Blind People (RNIB) to translate your content into Braille so that blind and partially sighted people can read your messages.    |
-| Audio CD | Includes the original letter and a CD that plays a spoken recording of your letter's content.  |
+| Accessible format | Description                                                                                                                                                                                                                      |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Large print       | Letters that have a larger font than usual. Large print letters typically have a point size of 16 and above.                                                                                                                     |
+| Braille           | Includes the original letter and a Braille insert. NHS Notify uses the Royal National Institute of Blind People (RNIB) to translate your content into Braille so that blind and partially sighted people can read your messages. |
+| Audio CD          | Includes the original letter and a CD that plays a spoken recording of your letter's content.                                                                                                                                    |
+
+{% include components/action-link.html
+    url='/pricing/letters'
+    text='More about accessible letter format pricing'
+%}
 
 ## Other accessible formats
 
@@ -33,7 +38,7 @@ You can include links in your messages to take recipients to other accessible fo
 
 You’ll need to arrange these accessible formats. NHS Notify does not provide them for you.
 
-This is available for NHS App messages, emails, text messages and letters
+This is available for all message channels.
 
 ## How to send messages in accessible formats
 
@@ -58,11 +63,9 @@ Provide recipients' NHS numbers as separate data files for each type of accessib
 
 It’s your responsibility to message recipients based on their access needs.
 
-NHS Notify can check who needs accessible formats, but we’ll only send them an accessible format if you've created a template that matches.
-
-We’ll send the accessible letter format if:
+NHS Notify can check who needs accessible formats, but we’ll only send them an accessible format if:
 
-- you've given us the accessible template
-- PDS confirms there are recipients with access needs
+- you've created an accessible template that matches
+- PDS confirms they have access needs
 
 We’ll send the standard letter if you've not given us the accessible template, even if PDS says there are recipients with access needs.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -27,4 +27,4 @@ If you work in NHS England and want to start using NHS Notify, find out how to [

		## I have questions about NHS Notify

		If you work in an NHS England team that’s not currently using NHS Notify and you have further questions, email our engagement team.
		If you work in an NHS England team that’s not currently using NHS Notify and you have further questions, email our engagement team via <[email protected]>.