SYN-735: Update spec to include 'modules' in Medicines API (#89)

* Added webpage to example JSON

* Added missing “webpage” properties in sandbox example JSON responses

* Added ‘modules’ param to medicines spec

Author: adrianparr

sandbox/responses/conditions-acne-modules-true.json

@@ -1,5 +1,9 @@
 {
-  "about": { "name": "Acne", "url": "https://api.service.nhs.uk/nhs-website-content/conditions/acne/" },
+  "about": {
+    "name": "Acne",
+    "url": "https://api.service.nhs.uk/nhs-website-content/conditions/acne/",
+    "webpage": "https://www.nhs.uk/conditions/acne/"
+  },
   "modules": [
     {
       "@type": "HealthTopicContent",

sandbox/responses/medicines-acrivastine-modules-true.json

@@ -1,5 +1,9 @@
 {
-  "about": { "name": "Acrivastine", "url": "https://api.service.nhs.uk/nhs-website-content/medicines/acrivastine/" },
+  "about": {
+    "name": "Acrivastine",
+    "url": "https://api.service.nhs.uk/nhs-website-content/medicines/acrivastine/",
+    "webpage": "https://www.nhs.uk/medicines/acrivastine/"
+  },
   "modules": [
     {
       "@type": "HealthTopicContent",

specification/components/examples/CommonHealthQuestionsContentPage.json

@@ -258,5 +258,6 @@
       "linkRelationship": "Navigation",
       "position": 2
     }
-  ]
+  ],
+  "webpage": "https://www.nhs.uk/common-health-questions/dental-health/why-should-i-use-dental-floss/"
 }

specification/nhs-website-content-api.yaml

@@ -391,14 +391,24 @@ paths:
   /medicines/*:
     parameters:
       - $ref: "#/components/parameters/apikey"
+      - $ref: "#/components/parameters/modules"
     get:
       summary: Get specific medicine page
       operationId: get-medicine-page
       description: |
         ## Overview
-        There is an endpoint for each page under the Medicines A to Z, for example https://www.nhs.uk/medicines/amoxicillin.
+        There is an endpoint for each page under the Medicines A to Z, for example https://www.nhs.uk/medicines/acrivastine.
 
         This can be used to get specific information about individual medicines.
+
+        There is only one query parameter for these pages:
+
+        | Query parameter   | Description                                                            | Type        |
+        | ----------------- | ---------------------------------------------------------------------- | ----------- |
+        | modules           | If topic is modularised, only return these modules                     | boolean     |
+
+        # Modularisation
+        We modularise some of our content, meaning that individual parts of the page can be reused. If a page is modularised, content appears in the `hasPart` field.
       responses:
         "200":
           description: |