Skip to content

Commit

Permalink
Merge branch 'develop'
Browse files Browse the repository at this point in the history
  • Loading branch information
@chrimesdev
chrimesdev committed Aug 21, 2019
2 parents 4fa3dc4 + a3385fe commit 753aaa1
Show file tree
Hide file tree
Showing 16 changed files with 160 additions and 87 deletions.
13 changes: 13 additions & 0 deletions CHANGELOG.md
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,18 @@
# NHS digital service manual Changelog

## 1.9.0 - Unreleased

:new: **New content**

- Add more guidance for content designers to the care card page
- Add "red book" and inclusive language terms to A to Z of NHS health writing

:wrench: **Fixes**

- Update inclusive language page in content style guide, especially guidance on sex, gender and sexuality
- Change "measurement" to "measurements" in Numbers, measurements, dates and time - and update links to this page
- Improve wording about ordinal numbers on Numbers, measurements, dates and time

## 1.8.0 - 09 August 2019

:new: **New content**
Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Run the project in development mode `npm run watch` and visit <a href="http://lo

## Get in touch

The NHS digital service manual is maintained by NHS Digital. [Email us](mailto:service-manual@nhs.net), open a [Github issue](https://github.com/nhsuk/nhsuk-service-manual/issues/new) or get in touch on the [NHS digital service manual Slack workspace](https://nhs-service-manual.slack.com/join/shared_invite/enQtNTIyOTEyNjU3NDkyLWUwOWM5MWY5MGRhYTYxZmY4ZWI0NDA1N2NhNTRiMGY3MTQxNjk5YTc3ZTAzMTA4YmE3ZDAxYmQ3MTQxNDgzOTQ).
The NHS digital service manual is maintained by NHS Digital. [Email us](mailto:service-manual@nhs.net), open a [GitHub issue](https://github.com/nhsuk/nhsuk-service-manual/issues/new) or get in touch on the [NHS digital service manual Slack workspace](https://nhs-service-manual.slack.com/join/shared_invite/enQtNTIyOTEyNjU3NDkyLWUwOWM5MWY5MGRhYTYxZmY4ZWI0NDA1N2NhNTRiMGY3MTQxNjk5YTc3ZTAzMTA4YmE3ZDAxYmQ3MTQxNDgzOTQ).

## Licence

Expand Down
45 changes: 30 additions & 15 deletions app/views/content/a-to-z-of-nhs-health-writing.njk
View file
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,8 @@
<h3 id="affects">affects</h3>
<p>It’s alright to use "affects" but in some contexts, for example with medicines, it can be better to say that "something changes the way something else works". </p>
<p>Check a dictionary if you’re not sure of the difference between "affect" and "effect".</p>
<h3 id="age">age</h3>
<p>Read about how we talk about age on the <a href="/service-manual/content/inclusive-language#age">Inclusive language</a> page.</p>
<h3 id="ageing">ageing</h3>
<p>Not "aging".</p>
<h3 id="alternative">alternative</h3>
Expand Down Expand Up @@ -224,7 +226,7 @@
<h3 id="condition">condition</h3>
<p>We use "condition", "problem" or "illness".</p>
<p>We avoid words like "disease" and "disorder" as they can sound negative. But we do use these words in the names of specific diseases or disorders, like Alzheimer’s disease or obsessive compulsive disorder (OCD) or terms like "tropical diseases".</p>
<p>See the section on <a href="/service-manual/content/inclusive-language">conditions in Inclusive language</a>.</p>
<p>Read about how we talk about disabilities and conditions on the <a href="/service-manual/content/inclusive-language#disabilities-and-conditions">Inclusive language</a> page.</p>
<h3 id="continuing-healthcare">continuing healthcare</h3>
<p>Lower case and "healthcare" is one word.</p>
<p>We explain <a href="https://www.nhs.uk/conditions/social-care-and-support-guide/money-work-and-benefits/nhs-continuing-healthcare/">NHS continuing healthcare</a> on the NHS website.</p>
Expand All @@ -240,16 +242,20 @@
<div class="nhsuk-a-z-list--results-items">
<h2 id="D">D</h2>
<h3 id="dates">dates</h3>
<p>See our guidance on <a href="/service-manual/content/numbers-measurement-dates-time">numbers, measurement, dates and time</a>.</p>
<p>See our guidance on dates on the <a href="/service-manual/content/numbers-measurements-dates-time#dates">Numbers, measurements, dates and time</a> page.</p>
<h3 id="degrees-(temperature)">degrees (temperature)</h3>
<p>We use C for centigrade or Celsius – for example, 38C or &minus;4C. Do not include the degree symbol (&deg;).</p>
<p>We are no longer including references to <a href="#Fahrenheit">Fahrenheit</a>.</p>
<p>Also see <a href="#fever">fever</a> and <a href="#temperature">temperature</a>.</p>
<h3 id="diabetic">diabetic</h3>
<p>We don’t talk about people as "diabetic". We say they have diabetes. See the section on <a href="/service-manual/content/inclusive-language">conditions in Inclusive language</a>.</p>
<p>We don’t talk about people as "diabetic". We say they have diabetes.</p>
<p>We do use "diabetic" in phrases like "diabetic eye screening".</p>
<p>Read more about how we talk about disabilities and conditions on <a href="/service-manual/content/inclusive-language#disabilities-and-conditions">the Inclusive language</a> page.</p>

<h3 id="dietitian">dietitian</h3>
<p>Not dietician.</p>
<h3 id="disabilities">disabilities</h3>
<p>We use positive language to talk about disabilities. Read more about how we talk about disabilities and conditions on our <a href="/service-manual/content/inclusive-language#disabilities-and-conditions">Inclusive language</a> page.</p>
<h3 id="diuretics">diuretics</h3>
<p>We don’t call them "water tablets". We explain that diuretics are "tablets that make you pee more".</p>
<h3 id="DNA">DNA</h3>
Expand All @@ -258,7 +264,7 @@
<p>We mostly use "GP". But where someone may see either a GP or another health professional, for example in hospital, we use "doctor".</p>
<p>Also see "<a href="#specialist">specialist</a>".</p>
<h3 id="dosage">dosage</h3>
<p>See <a href="/service-manual/content/numbers-measurement-dates-time#dosage">dosage</a> in our guidance on numbers, measurement, dates and time.</p>
<p>See dosage on our <a href="/service-manual/content/numbers-measurements-dates-time#dosage">Numbers, measurements, dates and time</a> page.</p>
<h3 id="drugs">drugs</h3>
<p>We use "medicines".</p>
<p>We only use "drugs" for illegal drugs.</p>
Expand All @@ -276,7 +282,8 @@
<h3 id="eg">eg</h3>
<p>eg can sometimes be read aloud as "egg" by screen readers. We prefer "for example" or "such as" or "like" or "including" – whichever works best.</p>
<h3 id="epileptic">epileptic</h3>
<p>We don’t talk about people as "epileptics". We say they have epilepsy. See the section on <a href="/service-manual/content/inclusive-language">conditions in Inclusive language</a>.</p>
<p>We don’t talk about people as "epileptics". We say they have epilepsy.</p>
<p>Read more about how we talk about conditions on the <a href="/service-manual/content/inclusive-language#disabilities-and-conditions">Inclusive language</a> page.</p>
<h3 id="equivalent">equivalent</h3>
<p>We use "equal to".</p>
<h3 id="etc">etc</h3>
Expand Down Expand Up @@ -326,7 +333,7 @@
<h3 id="foundation-trusts">foundation trust</h3>
<p>Lower case, unless you are giving the full name of a foundation trust. For example: Anytown NHS Foundation Trust.</p>
<h3 id="fractions">fractions</h3>
<p>See our guidance on <a href="/service-manual/content/numbers-measurement-dates-time">numbers, measurement, dates and time</a>.</p>
<p>See our guidance on fractions on the <a href="/service-manual/content/numbers-measurements-dates-time#fractions-and-percentages">Numbers, measurements, dates and time</a> page.</p>
<a class="nhsuk-back-to-top__link" href="#nhsuk-a-z-list">
<svg class="nhsuk-icon nhsuk-icon__arrow-right" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" aria-hidden="true">
<path d="M19.6 11.66l-2.73-3A.51.51 0 0 0 16 9v2H5a1 1 0 0 0 0 2h11v2a.5.5 0 0 0 .32.46.39.39 0 0 0 .18 0 .52.52 0 0 0 .37-.16l2.73-3a.5.5 0 0 0 0-.64z"></path>
Expand All @@ -338,6 +345,8 @@
<h2 id="G">G</h2>
<h3 id="gas">gas</h3>
<p>We don't use "gas". Instead we talk about "<a href="#wind">wind</a>", "<a href="#burp">burping</a>" or "<a href="#fart">farting</a>". </p>
<h3 id="gender">gender</h3>
<p>Read about how we talk about gender on the <a href="/service-manual/content/inclusive-language#sex-gender-sexuality">Inclusive language</a> page.</p>
<h3 id="GP">GP</h3>
<p>Where someone may see either a GP or another health professional, for example in hospital, use "doctor".</p>
<h3 id="GP-surgery">GP surgery</h3>
Expand Down Expand Up @@ -381,7 +390,7 @@
<p>Only use "immunisation" for the Public Health England (PHE) immunisation programme or Joint Committee on Vaccination and Immunisation (JCVI).</p>
<p>We use "<a href="#vaccination">vaccination</a>" otherwise.</p>
<h3 id="imperial-measurements">imperial measurements</h3>
<p>See the guidance in <a href="/service-manual/content/numbers-measurement-dates-time#metric-and-imperial">numbers, measurement, dates and time</a>.</p>
<p>See the guidance on metric and imperial measurements on the <a href="/service-manual/content/numbers-measurements-dates-time#metric-and-imperial">Numbers, measurements, dates and time</a> page.</p>
<h3 id="incurable">incurable</h3>
<p>We avoid "incurable". Instead we say "cannot be cured".</p>
<h3 id="injection">injection</h3>
Expand Down Expand Up @@ -427,14 +436,14 @@
<h2 id="M">M</h2>
<h3 id="mad-cow-disease">mad cow disease</h3>
<p>We use "<a href="#CJD">CJD</a>".</p>
<h3 id="measurement">measurement</h3>
<p>See our guidance on <a href="/service-manual/content/numbers-measurement-dates-time">numbers, measurement, dates and time</a>.</p>
<h3 id="measurements">measurements</h3>
<p>See the section on measurements on the <a href="/service-manual/content/numbers-measurements-dates-time#measurements">Numbers, measurements, dates and time</a> page.</p>
<h3 id="medical-record">medical record</h3>
<p>We prefer "<a href="#health-record">health record</a>".</p>
<h3 id="medication">medication</h3>
<p>We use "medicine".</p>
<h3 id="metric-measurements">metric measurements</h3>
<p>See the guidance in <a href="/service-manual/content/numbers-measurement-dates-time#metric-and-imperial">numbers, measurement, dates and time</a>.</p>
<p>See the guidance on metric and imperial measurements on the <a href="/service-manual/content/numbers-measurements-dates-time#metric-and-imperial">Numbers, measurements, dates and time</a> page.</p>
<h3 id="microgram">microgram</h3>
<p>Write "microgram" in full. Do not shorten it to "mcg".</p>
<p>It helps to explain that a microgram is 1,000 times smaller than a milligram (mg).</p>
Expand Down Expand Up @@ -482,7 +491,7 @@
<p>We use "usually".</p>
<p>"Normally" in a health context can make people feel they aren’t "normal".</p>
<h3 id="numbers">numbers</h3>
<p>See our guidance on <a href="/service-manual/content/numbers-measurement-dates-time">numbers, measurement, dates and time</a>.</p>
<p>See our guidance on <a href="/service-manual/content/numbers-measurements-dates-time">numbers, measurements, dates and time</a>.</p>
<a class="nhsuk-back-to-top__link" href="#nhsuk-a-z-list">
<svg class="nhsuk-icon nhsuk-icon__arrow-right" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" aria-hidden="true">
<path d="M19.6 11.66l-2.73-3A.51.51 0 0 0 16 9v2H5a1 1 0 0 0 0 2h11v2a.5.5 0 0 0 .32.46.39.39 0 0 0 .18 0 .52.52 0 0 0 .37-.16l2.73-3a.5.5 0 0 0 0-.64z"></path>
Expand Down Expand Up @@ -535,7 +544,7 @@
<p>We prefer "people" for content aimed at the general public but we sometimes use "patients" if the word "people" might be confusing, for example, where we need to distinguish patients from the general public.</p>
<p>"Patients" may also be more suitable in content for health professionals.</p>
<h3 id="percentages">percentages</h3>
<p>See our guidance on <a href="/service-manual/content/numbers-measurement-dates-time">numbers, measurement, dates and time</a>.</p>
<p>See our guidance on fractions and percentages on the <a href="/service-manual/content/numbers-measurements-dates-time#fractions-and-percentages">Numbers, measurements, dates and time</a> page.</p>
<h3 id="persist">persist</h3>
<p>We use "carry on" or "keep going".</p>
<h3 id="personal-child-health-record-(red-book)">personal child health record (red book)</h3>
Expand Down Expand Up @@ -567,11 +576,15 @@
</div>
<div class="nhsuk-a-z-list--results-items">
<h2 id="R">R</h2>
<h3 id="race">race</h3>
<p>Read about how we talk about race, ethnicity, religion and nationality on the <a href="/service-manual/content/inclusive-language#race-ethnicity-religion-nationality">Inclusive language</a> page.</p>
<h3 id="radiographer-or-radiologist">radiographer or radiologist</h3>
<p>Radiographers take X-rays. Radiologists read them.</p>
<h3 id="rectum">rectum</h3>
<p>We prefer "<a href="#bottom">bottom</a>" or "<a href="#anus">anus</a>". Only use "rectum" when the other alternatives aren't clear enough, for example when talking about surgery to remove part of the rectum.</p>
<p>We found that people don't search for "rectum" in Google as much as other terms.</p>
<h3 id="red-book">red book</h3>
<p>See <a href="#personal-child-health-record-(red-book)">personal child health record (red book)</a>.</p>
<h3 id="reduce-pain">reduce pain</h3>
<p>We say "help with pain" or "ease the pain".</p>
<h3 id="reduced-kidney-function">reduced kidney function</h3>
Expand Down Expand Up @@ -602,6 +615,8 @@
<h3 id="setting">setting</h3>
<p>We avoid the term "hospital setting". We just say "in hospital".</p>
<p>Instead of "community setting", we mention the place, for example, "in school", "in a clinic" or "at home".</p>
<h3 id="sex-and-sexuality">sex and sexuality</h3>
<p>Read about how we talk about sex, gender and sexuality on the <a href="/service-manual/content/inclusive-language#sex-gender-sexuality">Inclusive language</a> page.</p>
<h3 id="sexual-health-clinic">sexual health clinic</h3>
<p>We use "sexual health clinic", not "STI clinic".</p>
<p>Sexual health clinics can offer different services. So, when we mention them for the first time and are talking about STIs, we sometimes add that they may also be called "GUM clinics". When we are talking about contraception, we sometimes add that they may also be called "family planning or contraception clinics".</p>
Expand All @@ -621,7 +636,7 @@
<p>We generally use the word "specialist" for consultants and other specialist medical professions. For example, we use "a heart specialist" instead of "a cardiologist".</p>
<p>Also see "<a href="#doctor">doctor</a>".</p>
<h3 id="statistics">statistics</h3>
<p>See our guidance on <a href="/service-manual/content/numbers-measurement-dates-time">numbers, measurement, dates and time</a>.</p>
<p>See our guidance on statistics on the <a href="/service-manual/content/numbers-measurements-dates-time#statistics">Numbers, measurements, dates and time</a> page.</p>
<h3 id="STI">STI</h3>
<p>You might want to spell out "sexually transmitted infection" the first time you mention it. Otherwise it’s fine to use the abbreviation STI.</p>
<p>We talk about "a" sexually transmitted infection but "an" STI.</p>
Expand All @@ -635,7 +650,7 @@
<p>See <a href="#poo">poo</a>.</p>
<h3 id="suffering-from">suffering from</h3>
<p>We don’t use "suffering from". We talk about people having or living with a disability or condition.</p>
<p>See the section on <a href="/service-manual/content/inclusive-language">disabilities and conditions in Inclusive language.</a></p>
<p>Read more about how we talk about disabilities and conditions on the <a href="/service-manual/content/inclusive-language#disabilities-and-conditions">Inclusive language</a> page.</p>
<h3 id="summary-care-record">summary care record</h3>
<p>Lower case. Also see <a href="#health-record">health record</a>.</p>
<h3 id="surgery">surgery</h3>
Expand Down Expand Up @@ -666,7 +681,7 @@
<h3 id="terminal">terminal</h3>
<p>We use "terminal" when a condition or illness is likely to lead to death. We find that people with cancer, for example, often use this word.</p>
<h3 id="time">time</h3>
<p>See our guidance on <a href="/service-manual/content/numbers-measurement-dates-time">numbers, measurement, dates and time</a>.</p>
<p>See our guidance on time on the <a href="/service-manual/content/numbers-measurements-dates-time#time">Numbers, measurements, dates and time</a> page.</p>
<h3 id="tranquillise-and-tranquilliser">tranquillise and tranquilliser</h3>
<p>Note the double "ll". We use the British spelling with "s", not "z".</p>
<h3 id="try-to">try to</h3>
Expand Down
Loading

0 comments on commit 753aaa1

Please sign in to comment.