WIP add swagger ui to tech docs

Author: francisco-videira-nhs

.tool-versions

@@ -9,6 +9,7 @@ terraform-docs 0.19.0
 trivy 0.61.0
 vale 3.6.0
 poetry 2.1.4
+java openjdk-25.0.1
 
 # ==============================================================================
 # The section below is reserved for Docker image versions.

docs/Makefile

@@ -1,6 +1,7 @@
 BASE_URL ?= "/"
 VERSION ?= ""
 SHELL = /bin/bash
+SDK_DIR := ../sdk
 
 default: install
 
@@ -19,10 +20,12 @@ define baseurlparam =
 $(if $(BASE_URL),-- --baseurl $(BASE_URL),-- --baseurl "")
 endef
 
-build: version .generate-includes
+build: version .generate-includes $(SDK_DIR)/build
+	rsync -a --delete $(SDK_DIR)/swagger/ ./assets/swagger
 	npm run build $(baseurlparam)
 
-debug: version .generate-includes
+debug: version .generate-includes $(SDK_DIR)/build
+	rsync -a --delete $(SDK_DIR)/swagger/ ./assets/swagger
 	npm run debug
 
 version:
@@ -41,3 +44,6 @@ version:
 
 .generate-includes:
 	npm run generate-includes
+
+$(SDK_DIR)/build:
+	$(MAKE) -C $(SDK_DIR) build

docs/generate-includes.sh

@@ -10,10 +10,5 @@ mkdir -p ./docs/_includes/components/generated
 npm run -w internal/datastore diagrams
 cp ./internal/datastore/src/types.md ./docs/_includes/components/generated/types.md
 
-# Specifications
-npm run bundle-oas
-npm run generate:html
-cp ./sdk/html/index.html ./docs/_includes/components/generated/nhs-notify-supplier-api.html
-
 #Contributing file
 cp ./CONTRIBUTING.md ./docs/_includes/components/generated/contributing.md

docs/pages/specification.html

@@ -14,4 +14,10 @@
 permalink: /specification
 ---
 
-{% include components/generated/nhs-notify-supplier-api.html %}
+<div style="height:80vh">
+  <iframe
+    src="{{ '/assets/swagger/index.html' | relative_url }}"
+    style="width:100%;height:100%;border:0"
+    loading="lazy"
+  ></iframe>
+</div>