From 165da0ec67c94d2bfed00dd345890876043f0175 Mon Sep 17 00:00:00 2001
From: Dave Horton <daveh@beachdognet.com>
Date: Tue, 14 May 2024 07:34:13 -0400
Subject: [PATCH] docs (#90)

---
 .../supporting-articles/azure-private-link.md  | 18 ++++++++++++++++++
 markdown/docs/webhooks/recognizer.md           |  2 ++
 markdown/docs/webhooks/say.md                  |  2 ++
 package-lock.json                              | 12 ++++++------
 4 files changed, 28 insertions(+), 6 deletions(-)
 create mode 100644 markdown/docs/supporting-articles/azure-private-link.md

diff --git a/markdown/docs/supporting-articles/azure-private-link.md b/markdown/docs/supporting-articles/azure-private-link.md
new file mode 100644
index 0000000..7094d69
--- /dev/null
+++ b/markdown/docs/supporting-articles/azure-private-link.md
@@ -0,0 +1,18 @@
+# Azure on-prem and private link configurations
+
+Microsoft provides additional options to their hosted speech service, including running the speech service locally ("on prem") in a [Docker container](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/speech-container-overview) or using their [private link](https://learn.microsoft.com/en-us/azure/private-link/private-link-overview) service.
+
+## Docker container
+To use a Docker container, select the **Use Azure Docker container (on-prem)** option when creating a Microsoft speech service in the jambonz portal and supply the URLs for TTS (https) and STT (wss).  The subscription key is optional but can be supplied if your environment requires it.
+
+## Private link
+For private link, also select the **Use Azure Docker container (on-prem)** option.  
+
+- For TTS, enter the URL in the form of 
+```
+https://<private-link>.cognitiveservices.azure.com/tts/cognitiveservices/v1
+```
+- for STT enter the URL in the form of 
+```
+wss://<private link>.cognitiveservices.azure.com/stt/speech/recognition/conversation/cognitiveservices/v1
+```
\ No newline at end of file
diff --git a/markdown/docs/webhooks/recognizer.md b/markdown/docs/webhooks/recognizer.md
index df504a4..2d2db82 100644
--- a/markdown/docs/webhooks/recognizer.md
+++ b/markdown/docs/webhooks/recognizer.md
@@ -59,6 +59,8 @@ jambonz natively supports the following speech-to-text services:
 - nvidia
 - sonoix
 
+Note: Microsoft supports [on-prem and private link options](/docs/supporting-articles/azure-private-link) for deploying the speech service in addition to the hosted Microsoft service.
+
 <h2 id="hints">Providing speech hints</h2>
 
 google, microsoft, deepgram, and nvidia all support the ability to provide a dynamic list of words or phrases that should be "boosted" by the recognizer, i.e. the recognizer should be more likely to detect this terms and return them in the transcript.  A boost factor can also be applied.  In the most basic implementation it would look like this:
diff --git a/markdown/docs/webhooks/say.md b/markdown/docs/webhooks/say.md
index a78bb43..174d310 100644
--- a/markdown/docs/webhooks/say.md
+++ b/markdown/docs/webhooks/say.md
@@ -38,6 +38,8 @@ jambonz natively supports the following text-to-speech services:
 - wellsaid
 - whisper
 
+Note: Microsoft supports [on-prem and private link options](/docs/supporting-articles/azure-private-link) for deploying the speech service in addition to the hosted Microsoft service.
+
 <p class="flex">
 <a href="/docs/webhooks/redirect">Prev: redirect</a>
 <a href="/docs/webhooks/sip-decline">Next: sip:decline</a>
diff --git a/package-lock.json b/package-lock.json
index 5e55e7e..2cccc90 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1678,9 +1678,9 @@
       }
     },
     "node_modules/caniuse-lite": {
-      "version": "1.0.30001519",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001519.tgz",
-      "integrity": "sha512-0QHgqR+Jv4bxHMp8kZ1Kn8CH55OikjKJ6JmKkZYP1F3D7w+lnFXF70nG5eNfsZS89jadi5Ywy5UCSKLAglIRkg==",
+      "version": "1.0.30001618",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001618.tgz",
+      "integrity": "sha512-p407+D1tIkDvsEAPS22lJxLQQaG8OTBEqo0KhzfABGk0TU4juBNDSfH0hyAp/HRyx+M8L17z/ltyhxh27FTfQg==",
       "funding": [
         {
           "type": "opencollective",
@@ -8329,9 +8329,9 @@
       "dev": true
     },
     "caniuse-lite": {
-      "version": "1.0.30001519",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001519.tgz",
-      "integrity": "sha512-0QHgqR+Jv4bxHMp8kZ1Kn8CH55OikjKJ6JmKkZYP1F3D7w+lnFXF70nG5eNfsZS89jadi5Ywy5UCSKLAglIRkg=="
+      "version": "1.0.30001618",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001618.tgz",
+      "integrity": "sha512-p407+D1tIkDvsEAPS22lJxLQQaG8OTBEqo0KhzfABGk0TU4juBNDSfH0hyAp/HRyx+M8L17z/ltyhxh27FTfQg=="
     },
     "caseless": {
       "version": "0.12.0",