refresh speech docs 1

Author: eric-urban

articles/ai-services/speech-service/toc.yml

@@ -48,6 +48,22 @@ items:
   - name: Install the Speech SDK
     href: quickstarts/setup-platform.md
     displayName: get started, install, download, get sdk, get the sdk
+  - name: Logs and diagnostics
+    items:
+      - name: Enable logs in SDK
+        href: how-to-use-logging.md
+      - name: Log audio and transcriptions
+        href: logging-audio-transcription.md
+      - name: Troubleshoot the Speech SDK
+        href: troubleshooting.md
+        displayName: help, faq, tsg, error
+      - name: Get Speech to text Session ID
+        href: how-to-get-speech-session-id.md
+      - name: Track memory usage
+        href: how-to-track-speech-sdk-memory-usage.md
+  - name: Generate a REST API client library
+    href: swagger-documentation.md
+    displayName: rest, swagger
 - name: Speech to text
   items:
     - name: Speech to text documentation
@@ -286,7 +302,126 @@ items:
       href: custom-keyword-basics.md
     - name: Recommendations and guidelines
       href: keyword-recognition-guidelines.md
-- name: Scenario deep-dives
+- name: Infrastructure & security
+  items:
+    - name: Audio configuration
+      items:
+      - name: Audio concepts
+        href: concepts/audio-concepts.md
+      - name: How to use the audio input stream
+        href: how-to-use-audio-input-streams.md
+      - name: How to use compressed input audio
+        href: how-to-use-codec-compressed-audio-input-streams.md
+        displayName: codec,codecs,compression,compressed,mp3,flac,mulaw,alaw,mp4,mp4a,wav,opus,ogg,pcm,silk
+      - name: Select a specific microphone input device
+        href: how-to-select-audio-input-devices.md
+    - name: Access control and authentication
+      items:
+      - name: Role-based access with Microsoft Entra ID 
+        href: role-based-access-control.md
+      - name: Use Microsoft Entra authentication
+        href: how-to-configure-azure-ad-auth.md
+    - name: Containers
+      items:
+        - name: Speech containers overview
+          href: speech-container-overview.md
+        - name: Get started with speech containers
+          items:
+          - name: Install and run speech containers
+            displayName: 'containers,install container,run container'
+            href: speech-container-howto.md
+          - name: Speech to text containers
+            href: speech-container-stt.md
+          - name: Custom speech to text containers
+            href: speech-container-cstt.md
+          - name: Text to speech containers
+            href: speech-container-ntts.md
+          - name: Language identification containers
+            href: speech-container-lid.md
+        - name: Configure speech containers
+          displayName: 'containers,configure containers,container config,configuration'
+          href: speech-container-configuration.md
+        - name: Batch processing with speech containers
+          href: speech-container-batch-processing.md
+        - name: Speech containers with Kubernetes and Helm
+          displayName: 'containers,kubernetes,k8s,helm,orchestration,on-prem,on-premises'
+          href: speech-container-howto-on-premises.md
+        - name: Speech containers on Azure container instances
+          href: ../containers/azure-container-instance-recipe.md?context=/azure/ai-services/speech-service/context/context
+          displayName: 'ACI,azure container instances,container instances,containers'
+        - name: Containers FAQ
+          href: speech-container-faq.yml
+    - name: Devices
+      items:
+        - name: Devices overview
+          href: speech-devices.md
+        - name: Audio processing
+          href: audio-processing-overview.md
+        - name: Use the Microsoft Audio Stack (MAS)
+          href: audio-processing-speech-sdk.md
+        - name: Microphone array recommendations
+          href: speech-sdk-microphone.md
+    - name: Embedded speech
+      items:
+        - name: Embedded speech overview
+          href: embedded-speech.md
+        - name: Evaluate performance of embedded speech
+          href: embedded-speech-performance-evaluations.md
+    - name: Endpoint connections
+      items:
+      - name: Enable private endpoint
+        href: speech-services-private-link.md
+      - name: Enable VNet service endpoint
+        href: speech-service-vnet-service-endpoint.md
+      - name: Control and monitor connection status
+        href: how-to-control-connections.md
+      - name: Configure OpenSSL for Linux
+        displayName: memory usage, memory consumption, object logging, object tracking, memory, openssl
+        href: how-to-configure-openssl-linux.md
+      - name: Set up Virtual Networks
+        href: ../cognitive-services-virtual-networks.md?context=/azure/ai-services/speech-service/context/context
+        displayName: vpn
+    - name: Sovereign Clouds
+      displayName: fairfax,mooncake,compliant,secret,compliance,government,government cloud,dod,china
+      href: sovereign-clouds.md
+    - name: Storage and backup
+      items:
+      - name: Bring your own storage (BYOS)
+        items:
+        - name: Set up BYOS Speech resource
+          href: bring-your-own-storage-speech-resource.md
+          displayName: byos
+        - name: Use BYOS Speech resource for Speech to text
+          href: bring-your-own-storage-speech-resource-speech-to-text.md
+          displayName: byos speech to text
+      - name: Use customer-managed keys
+        href: speech-encryption-of-data-at-rest.md
+        displayName: encrypt, byos
+      - name: How to back up and recover speech customization resources
+        href: resiliency-and-recovery-plan.md
+    - name: Migration
+      items:
+        - name: Neural voice migration
+          items:
+            - name: Migration overview
+              href: migration-overview-neural-voice.md
+            - name: Migrate to custom neural voice 
+              href: how-to-migrate-to-custom-neural-voice.md
+            - name: Migrate to prebuilt neural voice
+              href: how-to-migrate-to-prebuilt-neural-voice.md
+            - name: Migrate to custom voice API
+              href: migrate-to-custom-voice-api.md
+        - name: Speech to text REST API migration
+          items:
+          - name: From Speech to text v3.1 to v3.2
+            href: migrate-v3-1-to-v3-2.md
+            displayName: migrate,migration,deprecate,retire,sunset
+          - name: From Speech to text v3.0 to v3.1
+            href: migrate-v3-0-to-v3-1.md
+            displayName: migrate,migration,deprecate,retire,sunset
+        - name: From Long Audio API to Batch synthesis API
+          href: migrate-to-batch-synthesis.md
+- name: Scenario guides
   items:
     - name: Captioning
       items:
@@ -309,6 +444,8 @@ items:
         href: /azure/communication-services/concepts/call-automation/azure-communication-services-azure-cognitive-services-integration?context=/azure/ai-services/speech-service/context/context
     - name: Gaming integration
       href: gaming-concepts.md
+    - name: Language identification
+      href: language-identification.md
     - name: Language learning
       items:
       - name: Overview
@@ -367,143 +504,6 @@ items:
               href: windows-voice-assistants-best-practices.md
             - name: 'Samples and frequently asked questions'
               href: windows-voice-assistants-faq.yml
-- name: Containers
-  items:
-    - name: Speech containers overview
-      href: speech-container-overview.md
-    - name: Get started with speech containers
-      items:
-      - name: Install and run speech containers
-        displayName: 'containers,install container,run container'
-        href: speech-container-howto.md
-      - name: Speech to text containers
-        href: speech-container-stt.md
-      - name: Custom speech to text containers
-        href: speech-container-cstt.md
-      - name: Text to speech containers
-        href: speech-container-ntts.md
-      - name: Language identification containers
-        href: speech-container-lid.md
-    - name: Configure speech containers
-      displayName: 'containers,configure containers,container config,configuration'
-      href: speech-container-configuration.md
-    - name: Batch processing with speech containers
-      href: speech-container-batch-processing.md
-    - name: Speech containers with Kubernetes and Helm
-      displayName: 'containers,kubernetes,k8s,helm,orchestration,on-prem,on-premises'
-      href: speech-container-howto-on-premises.md
-    - name: Speech containers on Azure container instances
-      href: ../containers/azure-container-instance-recipe.md?context=/azure/ai-services/speech-service/context/context
-      displayName: 'ACI,azure container instances,container instances,containers'
-    - name: Containers FAQ
-      href: speech-container-faq.yml
-- name: Devices
-  items:
-    - name: Devices overview
-      href: speech-devices.md
-    - name: Audio processing
-      href: audio-processing-overview.md
-    - name: Use the Microsoft Audio Stack (MAS)
-      href: audio-processing-speech-sdk.md
-    - name: Microphone array recommendations
-      href: speech-sdk-microphone.md
-- name: Embedded speech
-  items:
-    - name: Embedded speech overview
-      href: embedded-speech.md
-    - name: Evaluate performance of embedded speech
-      href: embedded-speech-performance-evaluations.md
-- name: How-to guides
-  items:
-    - name: Language identification
-      href: language-identification.md
-    - name: Audio configuration
-      items:
-      - name: Audio concepts
-        href: concepts/audio-concepts.md
-      - name: How to use the audio input stream
-        href: how-to-use-audio-input-streams.md
-      - name: How to use compressed input audio
-        href: how-to-use-codec-compressed-audio-input-streams.md
-        displayName: codec,codecs,compression,compressed,mp3,flac,mulaw,alaw,mp4,mp4a,wav,opus,ogg,pcm,silk
-      - name: Select a specific microphone input device
-        href: how-to-select-audio-input-devices.md
-    - name: Access control and authentication
-      items:
-      - name: Role-based access with Microsoft Entra ID 
-        href: role-based-access-control.md
-      - name: Use Microsoft Entra authentication
-        href: how-to-configure-azure-ad-auth.md
-    - name: Endpoint connections
-      items:
-      - name: Enable private endpoint
-        href: speech-services-private-link.md
-      - name: Enable VNet service endpoint
-        href: speech-service-vnet-service-endpoint.md
-      - name: Control and monitor connection status
-        href: how-to-control-connections.md
-      - name: Configure OpenSSL for Linux
-        displayName: memory usage, memory consumption, object logging, object tracking, memory, openssl
-        href: how-to-configure-openssl-linux.md
-      - name: Set up Virtual Networks
-        href: ../cognitive-services-virtual-networks.md?context=/azure/ai-services/speech-service/context/context
-        displayName: vpn
-    - name: Sovereign Clouds
-      displayName: fairfax,mooncake,compliant,secret,compliance,government,government cloud,dod,china
-      href: sovereign-clouds.md
-    - name: Storage and backup
-      items:
-      - name: Use Bring your own storage (BYOS)
-        items:
-        - name: Set up BYOS Speech resource
-          href: bring-your-own-storage-speech-resource.md
-          displayName: byos
-        - name: Use BYOS Speech resource for Speech to text
-          href: bring-your-own-storage-speech-resource-speech-to-text.md
-          displayName: byos speech to text
-      - name: Use customer-managed keys
-        href: speech-encryption-of-data-at-rest.md
-        displayName: encrypt, byos
-      - name: How to back up and recover speech customization resources
-        href: resiliency-and-recovery-plan.md
-    - name: Logs and diagnostics
-      items:
-        - name: Enable logs in SDK
-          href: how-to-use-logging.md
-        - name: Log audio and transcriptions
-          href: logging-audio-transcription.md
-        - name: Troubleshoot the Speech SDK
-          href: troubleshooting.md
-          displayName: help, faq, tsg, error
-        - name: Get Speech to text Session ID
-          href: how-to-get-speech-session-id.md
-        - name: Track memory usage
-          href: how-to-track-speech-sdk-memory-usage.md
-    - name: Generate a REST API client library
-      href: swagger-documentation.md
-      displayName: rest, swagger
-    - name: Migration
-      items:
-        - name: Neural voice migration
-          items:
-            - name: Migration overview
-              href: migration-overview-neural-voice.md
-            - name: Migrate to custom neural voice 
-              href: how-to-migrate-to-custom-neural-voice.md
-            - name: Migrate to prebuilt neural voice
-              href: how-to-migrate-to-prebuilt-neural-voice.md
-            - name: Migrate to custom voice API
-              href: migrate-to-custom-voice-api.md
-        - name: Speech to text REST API migration
-          items:
-          - name: From Speech to text v3.1 to v3.2
-            href: migrate-v3-1-to-v3-2.md
-            displayName: migrate,migration,deprecate,retire,sunset
-          - name: From Speech to text v3.0 to v3.1
-            href: migrate-v3-0-to-v3-1.md
-            displayName: migrate,migration,deprecate,retire,sunset
-        - name: From Long Audio API to Batch synthesis API
-          href: migrate-to-batch-synthesis.md
 - name: Reference
   items:
     - name: SDK reference