fixes

Author: alexwolfmsft

docs/ai/quickstarts/includes/clone-sample-repo.md

@@ -5,6 +5,8 @@ ms.date: 07/03/2024
 ms.topic: include
 ---
 
+## Clone the sample repository
+
  You can create your own app and follow along the steps in the sections ahead, or you can clone the GitHub repository that contains the completed sample apps for all of the quickstarts. The sample repo is also structured as an Azure Developer CLI template that can provision an Azure OpenAI resource for you.
 
 ```bash

docs/ai/quickstarts/includes/prerequisites-azure-openai.md

@@ -5,6 +5,8 @@ ms.date: 05/22/2024
 ms.topic: include
 ---
 
+## Prerequisites
+
 - .NET 8 SDK - [Install the .NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0).
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free).
 - Access to [Azure OpenAI service](/azure/ai-services/openai/overview#how-do-i-get-access-to-azure-openai).

docs/ai/quickstarts/includes/prerequisites-openai.md

@@ -5,6 +5,8 @@ ms.date: 07/03/2024
 ms.topic: include
 ---
 
+## Prerequisites
+
 - .NET 8.0 SDK - [Install the .NET 8.0 SDK](https://dotnet.microsoft.com/download/dotnet/8.0).
 - An [API key from OpenAI](https://platform.openai.com/docs/quickstart/account-setup) so you can run this sample.
 - On Windows, PowerShell `v7+` is required. To validate your version, run `pwsh` in a terminal. It should return the current version. If it returns an error, execute the following command: `dotnet tool update --global PowerShell`.

docs/ai/quickstarts/quickstart-openai-summarize-text.md

@@ -14,8 +14,6 @@ zone_pivot_groups: openai-library
 
 In this quickstart, learn how to create a .NET console chat app to connect to and prompt an OpenAI or Azure OpenAI model. The app uses the [`Microsoft.Extensions.AI`](https://www.nuget.org/packages/Microsoft.Extensions.AI) library so you can write code using AI abstractions rather than a specific SDK. AI abstractions enable you to change the underlying AI model with minimal code changes.
 
-## Prerequisites
-
 :::zone target="docs" pivot="openai"
 
 [!INCLUDE [azure-openai-prereqs](includes/prerequisites-azure-openai.md)]
@@ -28,12 +26,12 @@ In this quickstart, learn how to create a .NET console chat app to connect to an
 
 :::zone-end
 
-## Clone the sample repository
-
 [!INCLUDE [clone-sample-repo](includes/clone-sample-repo.md)]
 
 ## Create the app
 
+Complete the following steps to create a .NET console app to connect to an AI service.
+
 1. In an empty directory on your computer, use the `dotnet new` command to create a new console app:
 
     ```dotnetcli
@@ -48,9 +46,8 @@ In this quickstart, learn how to create a .NET console chat app to connect to an
 
 1. Install the required packages:
 
-:::zone target="docs" pivot="azure-openai"
+    :::zone target="docs" pivot="azure-openai"
 
-    <!-- markdownlint-disable MD046 -->
     ```bash
     dotnet add package Azure.Identity
     dotnet add package Azure.AI.OpenAI
@@ -59,19 +56,18 @@ In this quickstart, learn how to create a .NET console chat app to connect to an
     dotnet add package Microsoft.Extensions.Configuration.UserSecrets
     ```
 
-:::zone-end
+    :::zone-end
 
-:::zone target="docs" pivot="openai"
+    :::zone target="docs" pivot="openai"
 
-    <!-- markdownlint-disable MD046 -->
     ```bash
     dotnet add package OpenAI
     dotnet add package Microsoft.Extensions.AI.OpenAI
     dotnet add package Microsoft.Extensions.Configuration
     dotnet add package Microsoft.Extensions.Configuration.UserSecrets
     ```
 
-:::zone-end
+    :::zone-end
 
 1. Open the app in Visual Studio code or your editor of choice
 
@@ -87,26 +83,20 @@ The app uses the [`Microsoft.SemanticKernel`](https://www.nuget.org/packages/Mic
 
 1. In the **Program.cs** file, add the following code to connect and authenticate to the AI model.
 
-:::zone target="docs" pivot="azure-openai"
+    :::zone target="docs" pivot="azure-openai"
 
-    <!-- markdownlint-disable MD046 -->
     :::code language="csharp" source="snippets/prompt-completion/azure-openai/program.cs" range="6-14":::
 
     > [!NOTE]
     > `DefaultAzureCredential` searches for credentials from  your local tooling. If you are not using the `azd` template to provision the Azure OpenAI resource, you'll need to assign the `Azure AI Developer` role to the account you used to sign-in to Visual Studio or the Azure CLI.
 
-:::zone-end
-
-:::zone target="docs" pivot="azure-openai"
+    :::zone-end
 
-    <!-- markdownlint-disable MD046 -->
-    # [OpenAI](#tab/openai)
+    :::zone target="docs" pivot="azure-openai"
 
     :::code language="csharp" source="snippets/prompt-completion/openai/program.cs" range="5-13":::
 
-    ---
-
-:::zone-end
+    :::zone-end
 
 1. Read the `benefits.md` file content and use it to create a `prompt` for model. The prompt instructs the model to summarize the file text content.