Skip to content

Commit d7fd41f

Browse files
committed
CCM-8855: update README.md
1 parent 069c532 commit d7fd41f

File tree

2 files changed

+26
-15
lines changed

2 files changed

+26
-15
lines changed

LICENCE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# MIT Licence
22

3-
Copyright (c) 2024 Crown Copyright NHS England.
3+
Copyright (c) 2025 Crown Copyright NHS England.
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 25 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,17 @@
1-
# NHS Notify Repository Template
1+
# NHS Notify Supplier API
22

3-
[![CI/CD Pull Request](https://github.com/nhs-england-tools/repository-template/actions/workflows/cicd-1-pull-request.yaml/badge.svg)](https://github.com/nhs-england-tools/repository-template/actions/workflows/cicd-1-pull-request.yaml)
4-
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=repository-template&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=repository-template)
3+
[![1. CI/CD pull request](https://github.com/NHSDigital/nhs-notify-supplier-api/actions/workflows/cicd-1-pull-request.yaml/badge.svg)](https://github.com/NHSDigital/nhs-notify-supplier-api/actions/workflows/cicd-1-pull-request.yaml)
4+
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=nhs-notify-supplier-api&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=nhs-notify-supplier-api)
55

6-
Start with an overview or a brief description of what the project is about and what it does. For example -
6+
The NHS Notify Supplier API is intended primarily for print suppliers to integrate with the NHS Notify message request queueing system.
77

8-
Welcome to our repository template designed to streamline your project setup! This robust template provides a reliable starting point for your new projects, covering an essential tech stack and encouraging best practices in documenting.
8+
It models the concepts needed to configure production of letters and other printed materials to specific specifications, provide proofs of these materials, receive batch production requests, provide details of returned letters and correspondence, and to report on the status of these artifacts and associated management information such as volumes and assocated costs.
99

10-
This repository template aims to foster a user-friendly development environment by ensuring that every included file is concise and adequately self-documented. By adhering to this standard, we can promote increased clarity and maintainability throughout your project's lifecycle. Bundled within this template are resources that pave the way for seamless repository creation. Currently supported technologies are:
11-
12-
- Terraform
13-
- Docker
14-
15-
Make use of this repository template to expedite your project setup and enhance your productivity right from the get-go. Enjoy the advantage of having a well-structured, self-documented project that reduces overhead and increases focus on what truly matters - coding!
10+
This repository documents the Supplier API specification and provides an SDK with examples and reference client implementations for interacting with it.
1611

1712
## Table of Contents
1813

19-
- [NHS Notify Repository Template](#nhs-notify-repository-template)
14+
- [NHS Notify Supplier API](#nhs-notify-supplier-api)
2015
- [Table of Contents](#table-of-contents)
2116
- [Documentation](#documentation)
2217
- [Setup](#setup)
@@ -38,6 +33,8 @@ Make use of this repository template to expedite your project setup and enhance
3833

3934
## Setup
4035

36+
> TODO
37+
4138
By including preferably a one-liner or if necessary a set of clear CLI instructions we improve user experience. This should be a frictionless installation process that works on various operating systems (macOS, Linux, Windows WSL) and handles all the dependencies.
4239

4340
Clone the repository
@@ -49,6 +46,8 @@ cd nhs-england-tools/repository-template
4946

5047
### Prerequisites
5148

49+
> TODO
50+
5251
The following software packages, or their equivalents, are expected to be installed and configured:
5352

5453
- [Docker](https://www.docker.com/) container runtime or a compatible tool, e.g. [Podman](https://podman.io/),
@@ -75,6 +74,8 @@ The following software packages, or their equivalents, are expected to be instal
7574
7675
### Configuration
7776
77+
> TODO
78+
7879
Installation and configuration of the toolchain dependencies
7980
8081
```shell
@@ -83,16 +84,22 @@ make config
8384
8485
## Usage
8586

87+
> TODO
88+
8689
After a successful installation, provide an informative example of how this project can be used. Additional code snippets, screenshots and demos work well in this space. You may also link to the other documentation resources, e.g. the [User Guide](./docs/user-guide.md) to demonstrate more use cases and to show more features.
8790

8891
### Testing
8992

93+
> TODO
94+
9095
There are `make` tasks for you to configure to run your tests. Run `make test` to see how they work. You should be able to use the same entry points for local development as in your CI pipeline.
9196

9297
## Design
9398

9499
### Diagrams
95100

101+
> TODO
102+
96103
The [C4 model](https://c4model.com/) is a simple and intuitive way to create software architecture diagrams that are clear, consistent, scalable and most importantly collaborative. This should result in documenting all the system interfaces, external dependencies and integration points.
97104

98105
![Repository Template](./docs/diagrams/Repository_Template_GitHub_Generic.png)
@@ -111,10 +118,14 @@ sequenceDiagram
111118

112119
### Modularity
113120

121+
> TODO
122+
114123
Most of the projects are built with customisability and extendability in mind. At a minimum, this can be achieved by implementing service level configuration options and settings. The intention of this section is to show how this can be used. If the system processes data, you could mention here for example how the input is prepared for testing - anonymised, synthetic or live data.
115124

116125
## Contributing
117126

127+
> TODO
128+
118129
Describe or link templates on how to raise an issue, feature request or make a contribution to the codebase. Reference the other documentation files, like
119130

120131
- Environment setup for contribution, i.e. `CONTRIBUTING.md`
@@ -125,12 +136,12 @@ Describe or link templates on how to raise an issue, feature request or make a c
125136

126137
## Contacts
127138

139+
> TODO
140+
128141
Provide a way to contact the owners of this project. It can be a team, an individual or information on the means of getting in touch via active communication channels, e.g. opening a GitHub discussion, raising an issue, etc.
129142

130143
## Licence
131144

132-
> The [LICENCE.md](./LICENCE.md) file will need to be updated with the correct year and owner
133-
134145
Unless stated otherwise, the codebase is released under the MIT License. This covers both the codebase and any sample code in the documentation.
135146

136147
Any HTML or Markdown documentation is [© Crown Copyright](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/) and available under the terms of the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).

0 commit comments

Comments
 (0)