Service discovery page #1095 How to resolve the provider organisation…

…'s ODS code on DOS #1109

pages/appointments/appointments_service_discovery.md

@@ -64,7 +64,7 @@ Once a consumer system user has selected a service from the list returned by the
 
 This logic is described in the context of a full [GP Connect workflow example](https://developer.nhs.uk/apis/uec-appointments/dos_endpoints_booking.html) in the Urgent and Emergency Care Appointment Booking specification.
 
-##### Service filtering #####
+##### DOS service filtering #####
 
 Consumer systems that have used the DOS to determine a practice to book at must send the DOS service ID as part of the [Search for free slots](appointments_use_case_search_for_free_slots.html#search-parameters) call.
 

pages/overview/release_notes/1_2_8.md

@@ -10,7 +10,7 @@ toc: true
 
 ## Introduction ##
 
-The GP Connect API 1.2.8 release contains Appointment Management changes to support slot searching by DOS Service ID.
+The GP Connect API 1.2.8 release contains Appointment Management changes to support service filtering.
 
 ## 1.2.8 changes ##
 
@@ -66,7 +66,7 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 
 **Description:**
 
-- New read healthcare service endpoint to return services from the service list in the organisation configuration for service ID filtering
+- New read healthcare service endpoint to return services from the service list in the organisation configuration for service filtering
 
 **Pages changed:**
 
@@ -89,7 +89,7 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 
 **Description:**
 
-- New find a healthcare service endpoint to return services from the service list in the organisation configuration for service ID filtering
+- New find a healthcare service endpoint to return services from the service list in the organisation configuration for service filtering
 
 **Pages changed:**
 
@@ -102,7 +102,7 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 
 ## Appointment Management ##
 
-### Service ID filtering global supplier switch ###
+### Service filtering global supplier switch ###
 
 **Tickets:**  [#1080](https://github.com/nhsconnect/gpconnect/issues/1080)
 
@@ -112,15 +112,15 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 
 **Description:**
 
-- A global supplier-controlled feature visibility switch to support the rollout of service ID filtering
+- A global supplier-controlled feature visibility switch to support the rollout of service filtering
 
 **Pages changed:**
 
-- [Provider system configuration for service ID filtering](appointments_serviceid_configuration.html)
+- [Provider system configuration for service filtering](appointments_service_configuration.html)
 
 ---
 
-### Service ID filtering organisation configuration ###
+### Service filtering organisation configuration ###
 
 **Tickets:**  [#1081](https://github.com/nhsconnect/gpconnect/issues/1081)
 
@@ -130,14 +130,14 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 
 **Description:**
 
-- Organisation configuration screen(s) for service ID filtering, allowing users to:
+- Organisation configuration screen(s) for service filtering, allowing users to:
   - create and maintain a list of services (service IDs and names) provided by their organisation
   - link schedules and services
-  - switch on (or switch off) service ID filtering
+  - switch on (or switch off) service filtering
 
 **Pages changed:**
 
-- [Provider system configuration for service ID filtering](appointments_serviceid_configuration.html)
+- [Provider system configuration for service filtering](appointments_service_configuration.html)
 
 ---
 
@@ -165,7 +165,7 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 
 ---
 
-### Update FHIR resources page ###
+### FHIR resources ###
 
 **Tickets:**  [#1082](https://github.com/nhsconnect/gpconnect/issues/1082)
 
@@ -186,6 +186,26 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 
 ---
 
+### Service discovery ###
+
+**Tickets:**  [#1095](https://github.com/nhsconnect/gpconnect/issues/1095), [#1109](https://github.com/nhsconnect/gpconnect/issues/1109)
+
+**Affects:**  Appointment Management
+
+**Impacts:** Consumer systems
+
+**Description:**
+
+- Update the Directory of services section of the service discovery page:
+  - Add the logic to determine the ODS code to use for GP Connect (mirroring the UEC Appointment Booking specification's GP Connect workflow example)
+  - Add a section on service filtering
+
+**Pages changed:**
+
+- [Service discovery](appointments_service_discovery.html)
+
+---
+
 ### Search for free slots ###
 
 **Tickets:**  [#1084](https://github.com/nhsconnect/gpconnect/issues/1084)
@@ -202,7 +222,7 @@ The GP Connect API 1.2.8 release contains Appointment Management changes to supp
 - Introduce new `_include` parameter to return `HealthcareService` resources in the response bundle
   - may be sent by any consumer, regardless of the service discovery method
 
-- Describe the behaviour of the parameters with respect to the service ID filtering organisation switch
+- Describe the behaviour of the parameters with respect to the service  filtering organisation switch
 
 - Define a new filtering status valueset and populate in the Bundle.tag element where the consumer searched on `service.identifier`