Improvements to the main README.md documentation (#274)

* Move developer information out of main README

This should help clarify what instructions are useful for NMEs
vs what instructions should be followed by the internal team.

* Replace references to NHS Digital with NHS England

* Link to example JSON/XML mapping files from README

These should be useful context for a user trying to understand what
data the adaptor will generate.

Author: Adrian Clay

README.md

@@ -11,7 +11,8 @@ You can receive and route a “post event message” to their GP when NHS 111 re
 The NHS 111 Report adaptor can receive messages from the NHS 111 service and post them to the mailbox of the relevant GP practice.
 
 ## Adaptor Scope
-The main objective of the 111 Adaptor is to hide complex legacy standards and instead present a simple and consistent interface aligned to current NHSD national standards.  The adaptor receives ITK 2.2 wrapped Clinical Document Architecture (CDA) XML documents over web services, and converts them into structured FHIR messages before posting them onto the GP system's inbound event queue.
+The main objective of the 111 Adaptor is to hide complex legacy standards and instead present a simple and consistent interface aligned to current NHS England national standards.
+The adaptor receives ITK 2.2 wrapped Clinical Document Architecture (CDA) XML documents over web services, and converts them into structured FHIR messages before posting them onto the GP system's inbound event queue.
 
 The 111 adaptor consists of two docker images:[proxy](https://hub.docker.com/r/nhsdev/nia-111-nginx-adaptor) and [adaptor](https://hub.docker.com/r/nhsdev/nia-111-adaptor), you must deploy it within your own environment.
 
@@ -110,40 +111,19 @@ Nginx proxy is used to handle TLS MA. In order to configure it you need to set t
 * NGINX_CRL - Certificate revocation list
 * NGINX_CRL_URL - CRL URL - Nginx can download CRL on startup
 
-## ITK to FHIR Mapping
-Even though the adaptor removes this complexity, the [FHIR field mappings have been documented for information](doc/ITK_FHIR_mapping.md).
+## Mapping documentation
+To help understand what fields are populated by the adaptor we provide [ITK to FHIR field mappings](doc/ITK_FHIR_mapping.md).
 
-## Running the Adaptor
-
-### Pre requisites for running the Adaptor:
-1. JDK 17
-2. Docker
-
-### How to run service:
-* Navigate to `docker`
-* Run script: `./start-local-environment.sh`
-
-The above script builds the necessary docker images and starts the SpringBoot service and ActiveMQ
-* REST service `localhost:10001`
-* ActiveMQ: `localhost:5672`
-
-### How to run unit tests:
-* Navigate to `service`
-* Run: `./gradlew test`
-
-### How to run integration tests:
-* Navigate to `service`
-* Run: `./gradlew integrationTest`
-
-### Example bundle message 
-* An example bundle message can be found [here](doc/example_FHIR_bundle_message.json) of [ITK_Report](./service/src/integration-test/resources/xml/ITK_Report_request.xml) converted to FHIR.
-
-### AMQP Variables
-* Queue name: `encounter-report`
-* Broker: `amqp://activemq:5672`
+We also provide [example JSON payloads](doc/json) of what the adaptor generates from an [incoming XML payload](doc/xml).  
 
 ## ITK Testbench
-The [ITK Testbench](https://digital.nhs.uk/services/interoperability-toolkit/developer-resources/itk-test-centre/itk-testbench) provided by NHS Digital has an essential tool for ITK interface development and conformance.  This tool provides resources that will allow you to adequately test the 111 adaptor within your own environment.
+The [ITK Testbench] provided by NHS England has an essential tool for ITK interface development and conformance.
+This tool provides resources that will allow you to adequately test the 111 adaptor within your own environment.
+
+[ITK Testbench]: https://digital.nhs.uk/services/interoperability-toolkit/developer-resources/itk-test-centre/itk-testbench
 
 ## Test Pack
 Our testing pack as well our test harness can be found inside the test-suite directory [Test-Suite](./test-suite)
+
+## NIA Support (NHS England) guidance
+If you are looking to make changes to the adaptor you should first read the [guidance for developing the adaptor](nhs-england-developer-information.md).

nhs-england-developer-information.md

@@ -0,0 +1,31 @@
+# Developer Information
+
+> [!WARNING]
+> The audience of this documentation is designed for NHS England developers.
+
+## Pre requisites for running the Adaptor:
+1. JDK 17
+2. Docker
+
+## How to run service:
+* Navigate to `docker`
+* Run script: `./start-local-environment.sh`
+
+The above script builds the necessary docker images and starts the SpringBoot service and ActiveMQ
+* REST service `localhost:10001`
+* ActiveMQ: `localhost:5672`
+
+## How to run unit tests:
+* Navigate to `service`
+* Run: `./gradlew test`
+
+## How to run integration tests:
+* Navigate to `service`
+* Run: `./gradlew integrationTest`
+
+## Example bundle message
+* An example bundle message can be found [here](doc/example_FHIR_bundle_message.json) of [ITK_Report](./service/src/integration-test/resources/xml/ITK_Report_request.xml) converted to FHIR.
+
+## AMQP Variables
+* Queue name: `encounter-report`
+* Broker: `amqp://activemq:5672`