Skip to content

Commit 7d1317f

Browse files
Update readme
1 parent 15a6726 commit 7d1317f

File tree

1 file changed

+27
-55
lines changed

1 file changed

+27
-55
lines changed

README.md

Lines changed: 27 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,41 @@
1-
# NHS.UK prototype kit
1+
# NHS Screening event management prototype
22

3-
Visit the <a href="https://prototype-kit.service-manual.nhs.uk">NHS.UK prototype kit site</a> to download the latest version and read the documentation.
3+
A prototype for managing breast screening clinics and participants, built using the [NHS.UK prototype kit](https://prototype-kit.service.manual.nhs.uk).
44

5-
## About the NHS.UK prototype kit
5+
## About this prototype
66

7-
The NHS.UK prototype kit enables you to make interactive prototypes that will look like pages on NHS.UK. The prototypes you make are a great way to show ideas to others and for conducting user research.
7+
This prototype demonstrates a system for managing breast screening clinics, including:
8+
- Viewing and managing daily clinic lists
9+
- Tracking participants through their screening journey
10+
- Managing participant information and status
811

9-
## Security
10-
11-
If you publish your prototypes online, they must be protected by a <a href="https://prototype-kit.service-manual.nhs.uk/how-tos/publish-your-prototype-online">username and password</a>. This is to prevent members of the public finding prototypes and thinking they are real services.
12-
13-
You must protect user privacy at all times, even when using prototypes. Prototypes made with the kit look like NHS.UK, but do not have the same security provisions. Always make sure you are handling user data appropriately.
14-
15-
## Installation instructions
16-
17-
- <a href="https://prototype-kit.service-manual.nhs.uk/install/simple">Install guide (non technical)</a>
18-
- <a href="https://prototype-kit.service-manual.nhs.uk/install/advanced">Developer friendly install guide (technical)</a>
19-
20-
### Running the kit
21-
22-
Start the kit with `npm run watch`.
23-
24-
## Contribute
25-
26-
If you want to contribute to the NHS.UK prototype kit, by reporting bugs, fixing bugs, suggesting new features or writing documentation, then read our [contributing guidelines](CONTRIBUTING.md).
12+
The prototype includes auto-generated example data to demonstrate the interactions and user journeys.
2713

28-
## Development environment
14+
## Installation
2915

30-
Before running Gitpod, you must <a href="https://github.com/apps/gitpod-io/installations/new">install the Gitpod.io application on your GitHub account</a>.
16+
1. Follow the [NHS.UK prototype kit installation guide](https://prototype-kit.service.manual.nhs.uk/install/simple)
17+
2. Clone this repository
18+
3. Run `npm install`
19+
4. Run `npm run watch`
3120

32-
Gitpod also requires access to public repositories. Enable this via <a href="https://gitpod.io/integrations">Gitpod integrations</a>. (Click on the 3 dots to edit permissions for your GitHub account. Gitpod may pre-select permissions. You need read/write access to code in the repos.)
21+
The prototype will generate example data on first run.
3322

34-
Using your own GitHub credentials you can create, change, commit and push to branches on our Gitpod container via the "ready to code" button below.
23+
## Features
3524

36-
[![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/nhsuk/nhsuk-prototype-kit)
25+
- View all clinics or today's clinics
26+
- View clinic details and participant lists
27+
- Track participant status through their screening journey
28+
- View participant details within clinic context
3729

38-
Read an <a href="https://www.gitpod.io/docs">introduction to Gitpod (on Gitpod's website)</a>.
30+
## Development notes
3931

40-
## Release lifecycle
32+
- Example data is auto-generated in `app/data/generated`
33+
- Delete the generated folder to regenerate fresh example data
34+
- You can also run the generator directly with `node app/lib/generate-seed-data.js`
35+
- Uses NHS.UK design system components and patterns
4136

42-
> The below is only for maintainers of the prototype kit source code - these instructions aren't relevant if you're building your own prototype using the kit.
43-
44-
### Testing
45-
46-
Run unit tests locally with `npm run test`.
47-
48-
### Environments
49-
50-
### Versioning and releasing
51-
52-
- Merge required changes via PR into `main` branch
53-
- Ensure the version number in `package.json` and `CHANGELOG.md` match, with a summary of the changes included in the changelog
54-
- Pull down merged `main` branch to your local repository
55-
- Create a tag with the version number from the latest commit on `main`
56-
- If the latest version you're looking to push is version "1.2.3", you can do this on the command line with
57-
- `git tag v1.2.3`
58-
- `git push --tags`
59-
- [Github actions](https://github.com/nhsuk/nhsuk-prototype-kit/actions/workflows/release.yml) will spring to life and create a release which will be visible on the [releases tab](https://github.com/nhsuk/nhsuk-prototype-kit/releases) of the repository.
60-
- Finally, edit the description of the release to match the content entered into the changelog.
61-
- To deploy the changes to Live, the promotion to Live from the Preview environment must have the appropriate approval in Azure.
62-
63-
### Code Analysis
64-
65-
Code analysis results can be found in [SonarQube](https://sonar.nhswebsite.nhs.uk/dashboard?id=nhsuk-prototype-kit).
37+
## Security
6638

67-
## Support
39+
As with all prototypes made with the NHS.UK prototype kit, this is for research and testing only. Do not use real participant data.
6840

69-
The NHS.UK prototype kit is maintained by NHS England. [Email us](mailto:[email protected]), open a [Github issue](https://github.com/nhsuk/nhsuk-prototype-kit/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).
41+
If you publish your prototypes online, they must be protected by a username and password. This is to prevent members of the public finding prototypes and thinking they are real services.

0 commit comments

Comments
 (0)