diff --git a/README.md b/README.md index b7fb98c9..64fff443 100755 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ If you want to contribute to the NHS.UK prototype kit guidance, then read our [c We normally use the [NHS content guide](https://service-manual.nhs.uk/content) for terms. But there are some terms that are only used in the guidance for the kit: -### command line +#### command line Lower case. Only use for Windows instructions. Normally it will be ‘the command line’. @@ -27,20 +27,34 @@ Title case. #### NHS, NHS.UK, NHS England -Use ‘NHS.UK’ for products that are for delivery teams and not the public (find out more on the [NHS health writing A-Z](https://service-manual.nhs.uk/content/a-to-z-of-nhs-health-writing#N))This includes the NHS.UK prototype kit, NHS.UK design system, NHS.UK service manual or NHS.UK website. + +We are changing how we talk about tools for delivery teams. These used to be called 'NHS.UK' products but we are now removing the '.UK'. This means that we talk about the: + +* NHS frontend (though this is still sometimes called 'NHS.UK frontend') +* NHS digital service manual +* NHS design system +* NHS prototype kit + +For talking to the public about the website (find out more on the [NHS health writing A-Z](https://service-manual.nhs.uk/content/a-to-z-of-nhs-health-writing#N)) + #### NHS England laptops Use ‘NHS England Windows laptops’ instructions for people using corporate laptops. -#### NHS.UK prototype kit +#### NHS prototype kit -‘NHS.UK’ is in caps and ‘prototype kit’ in lower case (except where the NHS.UK is shown as a logo when it is then presented as ‘NHS Prototype kit’). Write out in full the first time it is used on a page, then call ’the kit’. Do not use ‘prototype kit’ if you can. +‘NHS’ is in caps and ‘prototype kit’ in lower case (except where it is shown next to the NHS logo when it is capitalised as ‘NHS Prototype kit’). Write out in full the first time it is used on a page, then call ’the kit’. Do not use ‘prototype kit’ if you can. #### terminal Lower case. Only use for Mac and Linux instructions. Usually it will be ‘the terminal’. +#### Visual Studio Code + +Title case. When you use it for the first time in a guide, start with 'Visual Studio Code (also known as VS Code)'. + + ## Support The NHS.UK prototype kit guidance website is maintained by NHS England. [Email us](), open a [Github issue](https://github.com/nhsuk/nhsuk.service-manual.prototype-kit.docs/issues/new) or get in touch on the [NHS digital service manual Slack workspace](https://join.slack.com/t/nhs-service-manual/shared_invite/enQtNTIyOTEyNjU3NDkyLTk4NDQ3YzkwYzk1Njk5YjAxYTI5YTVkZmUxMGQ0ZjA3NjMyM2ZkNjBlMWMxODVjZjYzNzg1ZmU4MWY1NmE2YzE). diff --git a/app/views/how-tos/build-basic-prototype/index.html b/app/views/how-tos/build-basic-prototype/index.html index 7e158802..c13c3171 100644 --- a/app/views/how-tos/build-basic-prototype/index.html +++ b/app/views/how-tos/build-basic-prototype/index.html @@ -10,52 +10,48 @@ {% block makePrototype %}

-This tutorial shows you how to prototype a fictional '{{exampleServiceName}}' service that will: + This tutorial shows you how to prototype a fictional '{{exampleServiceName}}' + service that will:

-It will take about an hour to finish this tutorial, after you install the Prototype Kit. -

- -

-Our prototype will look a bit like this: + It will take about an hour to finish this tutorial, after you install the + Prototype Kit.

+

Our prototype will look a bit like this:

- The first page has the title 'Start page' with the button 'Start now'. This is linked to a second page with the title 'Question 1' and a 'Continue' button. This forks to 2 different pages. 1 is titled 'Ineligible'. 2 is titled Question 2. Question 2 is linked to a page titled 'Check answers'. This links to page 6, titled 'Complete'. -
Diagram of 6 pages connected together.
+ The first page has the title 'Start page' with the button 'Start now'. This is linked to a second page with the title 'Question 1' and a 'Continue' button. This forks to 2 different pages. 1 is titled 'Ineligible'. 2 is titled Question 2. Question 2 is linked to a page titled 'Check answers'. This links to page 6, titled 'Complete'. +
+ Diagram of 6 pages connected together. +
- -

-Before you start -

+

Before you start

-Before you start, you must install and run the NHS.UK prototype kit. + Before you start, you must install and run the + NHS.UK prototype kit.

-You'll also need a code editor. These two are popular, well established and fairly accessible: + You'll also need a code editor. Any HTML text editor will do, but we recommend + Visual Studio Code (also known as + VS Code). This is because it is free and has lots of + useful features.

- - - - - Start now - +

+ Start now +

{% endblock %} diff --git a/app/views/install/requirements.html b/app/views/install/requirements.html index 84ac7f60..6e0ef88d 100644 --- a/app/views/install/requirements.html +++ b/app/views/install/requirements.html @@ -32,7 +32,7 @@

Software you need

This guide will show you how to install this software.

diff --git a/app/views/install/text-editor.html b/app/views/install/text-editor.html index ec1245a4..b61bb1d3 100644 --- a/app/views/install/text-editor.html +++ b/app/views/install/text-editor.html @@ -34,7 +34,7 @@

You'll need an HTML text editor to edit and make changes to your prototype.

-

Any HTML text editor will do, but we recommend Visual Studio Code which is free and has lots of useful features.

+

Any HTML text editor will do, but we recommend Visual Studio Code (also known as VS Code). This is because it is free and has lots of useful features.

Download Visual Studio Code (opens in new window)