Edits as requested

Author: diberry

articles/ai-services/openai/includes/text-to-speech-javascript.md

@@ -14,30 +14,23 @@ recommendations: false
 
 ## Prerequisites
 
-#### [TypeScript](#tab/typescript)
+#### [JavaScript](#tab/javascript)
 
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true)
 - [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule)
-- [TypeScript](https://www.typescriptlang.org/download/)
 - An Azure OpenAI resource created in a supported region (see [Region availability](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability)). For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
 
 
-#### [JavaScript](#tab/javascript)
+#### [TypeScript](#tab/typescript)
 
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true)
 - [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule)
+- [TypeScript](https://www.typescriptlang.org/download/)
 - An Azure OpenAI resource created in a supported region (see [Region availability](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability)). For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
 
----
-
-
-## Passwordless authentication is recommended
 
-For passwordless authentication, you need to 
 
-1. Use the `@azure/identity` package.
-1. Assign the `Cognitive Services User` role to your user account. This can be done in the Azure portal under **Access control (IAM)** > **Add role assignment**.
-1. Sign in with the Azure CLI such as `az login`.
+---
 
 ## Set up
 
@@ -112,16 +105,16 @@ Your app's _package.json_ file will be updated with the dependencies.
 ## Create a speech file
 
 
-#### [TypeScript](#tab/typescript)
 
-1. Create a new file named _Text-to-speech.ts_ and open it in your preferred code editor. Copy the following code into the _Text-to-speech.ts_ file:
+#### [JavaScript](#tab/javascript)
 
-    ```typescript
-    import "dotenv/config";
-    import { writeFile } from "fs/promises";
-    import { AzureOpenAI } from "openai";
-    import type { SpeechCreateParams } from "openai/resources/audio/speech";
-    import "openai/shims/node";
+1. Create a new file named _Text-to-speech.js_ and open it in your preferred code editor. Copy the following code into the _Text-to-speech.js_ file:
+
+    ```javascript
+    require("dotenv/config");
+    const { writeFile } = require("fs/promises");
+    const { AzureOpenAI } = require("openai");
+    require("openai/shims/node");
 
     // You will need to set these environment variables or edit the following values
     const endpoint = process.env["AZURE_OPENAI_ENDPOINT"] || "<endpoint>";
@@ -133,7 +126,7 @@ Your app's _package.json_ file will be updated with the dependencies.
     const deploymentName = "tts";
     const apiVersion = "2024-07-01-preview";
 
-    function getClient(): AzureOpenAI {
+    function getClient() {
       return new AzureOpenAI({
         endpoint,
         apiKey,
@@ -143,9 +136,9 @@ Your app's _package.json_ file will be updated with the dependencies.
     }
 
     async function generateAudioStream(
-      client: AzureOpenAI,
-      params: SpeechCreateParams
-    ): Promise<NodeJS.ReadableStream> {
+      client,
+      params
+    ) {
       const response = await client.audio.speech.create(params);
       if (response.ok) return response.body;
       throw new Error(`Failed to generate audio stream: ${response.statusText}`);
@@ -170,31 +163,24 @@ Your app's _package.json_ file will be updated with the dependencies.
     });
 
     ```
-    
-    The "openai/shims/node" import supports the ability for the a stream type that changes depending on whether you run in Node.js or in another environment such as a browser.
 
-1. Build the application with the following command:
-
-    ```console
-    tsc
-    ```
-
-1. Run the application with the following command:
+1. Run the script with the following command:
 
     ```console
     node Text-to-speech.js
     ```
+    
 
+#### [TypeScript](#tab/typescript)
 
-#### [JavaScript](#tab/javascript)
-
-1. Create a new file named _Text-to-speech.js_ and open it in your preferred code editor. Copy the following code into the _Text-to-speech.js_ file:
+1. Create a new file named _Text-to-speech.ts_ and open it in your preferred code editor. Copy the following code into the _Text-to-speech.ts_ file:
 
-    ```javascript
-    require("dotenv/config");
-    const { writeFile } = require("fs/promises");
-    const { AzureOpenAI } = require("openai");
-    require("openai/shims/node");
+    ```typescript
+    import "dotenv/config";
+    import { writeFile } from "fs/promises";
+    import { AzureOpenAI } from "openai";
+    import type { SpeechCreateParams } from "openai/resources/audio/speech";
+    import "openai/shims/node";
     
     // You will need to set these environment variables or edit the following values
     const endpoint = process.env["AZURE_OPENAI_ENDPOINT"] || "<endpoint>";
@@ -206,7 +192,7 @@ Your app's _package.json_ file will be updated with the dependencies.
     const deploymentName = "tts";
     const apiVersion = "2024-07-01-preview";
     
-    function getClient() {
+    function getClient(): AzureOpenAI {
       return new AzureOpenAI({
         endpoint,
         apiKey,
@@ -216,9 +202,9 @@ Your app's _package.json_ file will be updated with the dependencies.
     }
     
     async function generateAudioStream(
-      client,
-      params
-    ) {
+      client: AzureOpenAI,
+      params: SpeechCreateParams
+    ): Promise<NodeJS.ReadableStream> {
       const response = await client.audio.speech.create(params);
       if (response.ok) return response.body;
       throw new Error(`Failed to generate audio stream: ${response.statusText}`);
@@ -243,11 +229,19 @@ Your app's _package.json_ file will be updated with the dependencies.
     });
     
     ```
+    
+    The "openai/shims/node" import supports the ability for the a stream type that changes depending on whether you run in Node.js or in another environment such as a browser.
+
+1. Build the application with the following command:
+
+    ```console
+    tsc
+    ```
 
-1. Run the script with the following command:
+1. Run the application with the following command:
 
     ```console
     node Text-to-speech.js
     ```
-    
+
 ---

articles/ai-services/openai/includes/whisper-javascript.md

@@ -13,20 +13,22 @@ author: eric-urban
 
 ## Prerequisites
 
-#### [TypeScript](#tab/typescript)
+#### [JavaScript](#tab/javascript)
 
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true)
 - [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule)
-- [TypeScript](https://www.typescriptlang.org/download/)
 - An Azure OpenAI resource created in a supported region (see [Region availability](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability)). For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
 
 
-#### [JavaScript](#tab/javascript)
+
+#### [TypeScript](#tab/typescript)
 
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services?azure-portal=true)
 - [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule)
+- [TypeScript](https://www.typescriptlang.org/download/)
 - An Azure OpenAI resource created in a supported region (see [Region availability](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability)). For more information, see [Create a resource and deploy a model with Azure OpenAI](../how-to/create-resource.md).
 
+
 ---
 
 
@@ -111,14 +113,15 @@ Your app's _package.json_ file will be updated with the dependencies.
 
 ## Create a sample application
 
-#### [TypeScript](#tab/typescript)
+
+#### [JavaScript](#tab/javascript)
 
 1. Create a new file named _Whisper.js_ and open it in your preferred code editor. Copy the following code into the _Whisper.js_ file:
-    
-    ```typescript
-    import "dotenv/config";
-    import { createReadStream } from "fs";
-    import { AzureOpenAI } from "openai";
+
+    ```javascript
+    require("dotenv/config");
+    const { createReadStream } = require("fs");
+    const { AzureOpenAI } = require("openai");
 
     // You will need to set these environment variables or edit the following values
     const audioFilePath = process.env["AUDIO_FILE_PATH"] || "<audio file path>";
@@ -129,7 +132,7 @@ Your app's _package.json_ file will be updated with the dependencies.
     const apiVersion = "2024-07-01-preview";
     const deploymentName = "whisper";
 
-    function getClient(): AzureOpenAI {
+    function getClient() {
       return new AzureOpenAI({
         endpoint,
         apiKey,
@@ -155,26 +158,21 @@ Your app's _package.json_ file will be updated with the dependencies.
     });
     ```
 
-1. Build the application with the following command:
-
-    ```console
-    tsc
-    ```
-
-1. Run the application with the following command:
+1. Run the script with the following command:
 
     ```console
     node Whisper.js
     ```
 
-#### [JavaScript](#tab/javascript)
 
-1. Create a new file named _Whisper.js_ and open it in your preferred code editor. Copy the following code into the _Whisper.js_ file:
+#### [TypeScript](#tab/typescript)
 
-    ```javascript
-    require("dotenv/config");
-    const { createReadStream } = require("fs");
-    const { AzureOpenAI } = require("openai");
+1. Create a new file named _Whisper.js_ and open it in your preferred code editor. Copy the following code into the _Whisper.js_ file:
+    
+    ```typescript
+    import "dotenv/config";
+    import { createReadStream } from "fs";
+    import { AzureOpenAI } from "openai";
     
     // You will need to set these environment variables or edit the following values
     const audioFilePath = process.env["AUDIO_FILE_PATH"] || "<audio file path>";
@@ -185,7 +183,7 @@ Your app's _package.json_ file will be updated with the dependencies.
     const apiVersion = "2024-07-01-preview";
     const deploymentName = "whisper";
     
-    function getClient() {
+    function getClient(): AzureOpenAI {
       return new AzureOpenAI({
         endpoint,
         apiKey,
@@ -211,7 +209,13 @@ Your app's _package.json_ file will be updated with the dependencies.
     });
     ```
 
-1. Run the script with the following command:
+1. Build the application with the following command:
+
+    ```console
+    tsc
+    ```
+
+1. Run the application with the following command:
 
     ```console
     node Whisper.js

zone-pivots/zone-pivot-groups.yml

@@ -231,14 +231,14 @@ groups:
   title: Programming languages
   prompt: Choose a programming language
   pivots:
-  - id: rest-api
-    title: REST
-  - id: programming-language-powershell
-    title: PowerShell
-  - id: programming-language-python
-    title: Python
   - id: programming-language-javascript
     title: JavaScript
+  - id: programming-language-python
+    title: Python
+  - id: programming-language-powershell
+    title: PowerShell
+  - id: rest-api
+    title: REST
 # Owner: diberry
 - id: programming-languages-set-six
   title: Programming languages