Merge pull request #3133 from eric-urban/eur/order-zone-pivots

denrea · web-flow · commit 5aa1996bbffd · 2025-02-24T13:20:06.000-08:00
alphabetize and clean up pivots
diff --git a/articles/ai-services/agents/quickstart.md b/articles/ai-services/agents/quickstart.md
@@ -16,7 +16,7 @@ ms.custom: azure-ai-agents
 
 Azure AI Agent Service allows you to create AI agents tailored to your needs through custom instructions and augmented by advanced tools like code interpreter, and custom functions.
 
-::: zone pivot="ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [quickstart-ai-foundry](includes/quickstart-foundry.md)]
 
@@ -27,11 +27,13 @@ Azure AI Agent Service allows you to create AI agents tailored to your needs thr
 [!INCLUDE [quickstart-csharp](includes/quickstart-csharp.md)]
 
 ::: zone-end
+
 ::: zone pivot="programming-language-python-azure"
 
 [!INCLUDE [quickstart-python-azure](includes/quickstart-python.md)]
 
 ::: zone-end
+
 ::: zone pivot="programming-language-python-openai"
 
 [!INCLUDE [quickstart-python-openai](includes/quickstart-python-openai.md)]
@@ -41,15 +43,19 @@ Azure AI Agent Service allows you to create AI agents tailored to your needs thr
 ::: zone pivot="programming-language-javascript"
 
 [!INCLUDE [quickstart-javascript](includes/quickstart-javascript.md)]
+
 [!INCLUDE [quickstart-output](includes/quickstart-output.md)]
 
 ::: zone-end
+
 ::: zone pivot="programming-language-typescript"
 
 [!INCLUDE [quickstart-typescript](includes/quickstart-typescript.md)]
+
 [!INCLUDE [quickstart-output](includes/quickstart-output.md)]
 
 ::: zone-end
+
 ::: zone pivot="rest-api"
 
 [!INCLUDE [quickstart-rest](includes/quickstart-rest.md)]
diff --git a/articles/ai-services/language-service/key-phrase-extraction/quickstart.md b/articles/ai-services/language-service/key-phrase-extraction/quickstart.md
@@ -48,7 +48,7 @@ zone_pivot_groups: programming-languages-text-analytics
 
 ::: zone-end
 
-::: zone pivot="azure-ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
 
diff --git a/articles/ai-services/language-service/language-detection/quickstart.md b/articles/ai-services/language-service/language-detection/quickstart.md
@@ -48,7 +48,7 @@ zone_pivot_groups: programming-languages-text-analytics
 
 ::: zone-end
 
-::: zone pivot="azure-ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
 
diff --git a/articles/ai-services/language-service/named-entity-recognition/quickstart.md b/articles/ai-services/language-service/named-entity-recognition/quickstart.md
@@ -48,7 +48,7 @@ zone_pivot_groups: programming-languages-text-analytics
 
 ::: zone-end
 
-::: zone pivot="azure-ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
 
diff --git a/articles/ai-services/language-service/personally-identifiable-information/quickstart.md b/articles/ai-services/language-service/personally-identifiable-information/quickstart.md
@@ -50,7 +50,7 @@ zone_pivot_groups: programming-languages-text-analytics
 
 ::: zone-end
 
-::: zone pivot="azure-ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
 
diff --git a/articles/ai-services/language-service/sentiment-opinion-mining/quickstart.md b/articles/ai-services/language-service/sentiment-opinion-mining/quickstart.md
@@ -48,7 +48,7 @@ zone_pivot_groups: programming-languages-text-analytics
 
 ::: zone-end
 
-::: zone pivot="azure-ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
 
diff --git a/articles/ai-services/language-service/summarization/quickstart.md b/articles/ai-services/language-service/summarization/quickstart.md
@@ -49,7 +49,7 @@ zone_pivot_groups: programming-languages-text-analytics
 
 ::: zone-end
 
-::: zone pivot="azure-ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
 
diff --git a/articles/ai-services/language-service/text-analytics-for-health/quickstart.md b/articles/ai-services/language-service/text-analytics-for-health/quickstart.md
@@ -51,7 +51,7 @@ This article contains Text Analytics for health quickstarts that help with using
 
 ::: zone-end
 
-::: zone pivot="azure-ai-foundry"
+::: zone pivot="ai-foundry-portal"
 
 [!INCLUDE [Azure AI Foundry quickstart](includes/quickstarts/azure-ai-foundry.md)]
 
diff --git a/articles/ai-services/speech-service/how-to-configure-azure-ad-auth.md b/articles/ai-services/speech-service/how-to-configure-azure-ad-auth.md
@@ -113,11 +113,11 @@ aadToken = ibc.get_token("https://cognitiveservices.azure.com/.default")
 ```
 ::: zone-end
 
-::: zone pivot="programming-language-more"
+### More samples
+
 Find samples that get a Microsoft Entra access token in [Microsoft identity platform code samples](/azure/active-directory/develop/sample-v2-code).
 
 For programming languages where a Microsoft identity platform client library isn't available, you can directly [request an access token](/azure/active-directory/develop/v2-oauth-ropc).
-::: zone-end
 
 ## Get the Speech resource ID
 
diff --git a/articles/ai-services/speech-service/how-to-track-speech-sdk-memory-usage.md b/articles/ai-services/speech-service/how-to-track-speech-sdk-memory-usage.md
@@ -10,7 +10,7 @@ ms.topic: how-to
 ms.date: 9/20/2024
 ms.reviewer: rhurey
 ms.custom: devx-track-csharp, devx-track-extended-java, devx-track-python
-zone_pivot_groups: programming-languages-set-two
+zone_pivot_groups: programming-languages-set-two-objective-c
 #Customer intent: As a developer, I want to learn how to track memory usage in the Speech SDK so that I can manage resources effectively.
 ---
 
@@ -70,7 +70,7 @@ speech_config.set_property_by_name("SPEECH-ObjectCountWarnThreshold", "10000")?
 
 ::: zone-end
 
-::: zone pivot="programming-language-more"
+::: zone pivot="programming-language-objectivec"
 
 ```ObjectiveC
 [config setPropertyTo:@"10000" byName:"SPEECH-ObjectCountWarnThreshold"];
@@ -131,7 +131,7 @@ speech_config.set_property_by_name("SPEECH-ObjectCountErrorThreshold", "10000")?
 
 ::: zone-end
 
-::: zone pivot="programming-language-more"
+::: zone pivot="programming-language-objectivec"
 
 ```objc
 [config setPropertyTo:@"10000" byName:"SPEECH-ObjectCountErrorThreshold"];
diff --git a/articles/ai-services/speech-service/includes/how-to/intent-recognition/cpp/pattern-matching.md b/articles/ai-services/speech-service/includes/how-to/intent-recognition/cpp/pattern-matching.md
@@ -5,7 +5,6 @@ ms.service: azure-ai-speech
 ms.date: 11/15/2021
 ms.topic: include
 ms.author: chschrae
-zone_pivot_groups: programming-languages-set-two
 ---
 
 ## Create a project
@@ -51,7 +50,7 @@ Now create an `IntentRecognizer`. Insert this code right below your Speech confi
 ## Add some intents
 
 You need to associate some patterns with a `PatternMatchingModel` and apply it to the `IntentRecognizer`.
-We will start by creating a `PatternMatchingModel` and adding a few intents to it. A PatternMatchingIntent is a struct so we will just use the in-line syntax.
+We'll start by creating a `PatternMatchingModel` and adding a few intents to it. A PatternMatchingIntent is a struct so we just use the in-line syntax.
 
 > [!Note]
 > We can add multiple patterns to a `PatternMatchingIntent`.
@@ -65,15 +64,15 @@ model->Intents.push_back({"{action} the door."}, "OpenCloseDoor");
 
 ## Add some custom entities
 
-To take full advantage of the pattern matcher you can customize your entities. We will make "floorName" a list of the available floors.
+To take full advantage of the pattern matcher, you can customize your entities. We'll make "floorName" a list of the available floors.
 
 ```cpp
 model->Entities.push_back({ "floorName" , Intent::EntityType::List, Intent::EntityMatchMode::Strict, {"one", "1", "two", "2", "lobby", "ground floor"} });
 ```
 
 ## Apply our model to the Recognizer
 
-Now it is necessary to apply the model to the `IntentRecognizer`. It is possible to use multiple models at once so the API takes a collection of models.
+Now it's necessary to apply the model to the `IntentRecognizer`. It's possible to use multiple models at once so the API takes a collection of models.
 
 ```cpp
 std::vector<std::shared_ptr<LanguageUnderstandingModel>> collection;
@@ -95,7 +94,7 @@ auto result = intentRecognizer->RecognizeOnceAsync().get();
 
 ## Display the recognition results (or errors)
 
-When the recognition result is returned by the Speech service, we will print the result.
+When the Speech service returns the recognition result, we print the result.
 
 Insert this code below `auto result = intentRecognizer->RecognizeOnceAsync().get();`:
 
@@ -251,7 +250,7 @@ Now you're ready to build your app and test our speech recognition using the Spe
 
 1. **Compile the code** - From the menu bar of Visual Studio, choose **Build** > **Build Solution**.
 2. **Start your app** - From the menu bar, choose **Debug** > **Start Debugging** or press <kbd>F5</kbd>.
-3. **Start recognition** - It will prompt you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
+3. **Start recognition** - It prompts you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
 
 For example if you say "Take me to floor 2", this should be the output:
 
@@ -270,4 +269,4 @@ RECOGNIZED: Text = Take me to floor 7.
 NO INTENT RECOGNIZED!
 ```
 
-The Intent ID is empty because 7 was not in our list.
+The Intent ID is empty because 7 wasn't in our list.
diff --git a/articles/ai-services/speech-service/includes/how-to/intent-recognition/cpp/simple-pattern-matching.md b/articles/ai-services/speech-service/includes/how-to/intent-recognition/cpp/simple-pattern-matching.md
@@ -5,7 +5,6 @@ ms.service: azure-ai-speech
 ms.date: 01/03/2022
 ms.topic: include
 ms.author: chschrae
-zone_pivot_groups: programming-languages-set-two
 ---
 
 ## Create a project
@@ -51,7 +50,7 @@ Now create an `IntentRecognizer`. Insert this code right below your Speech confi
 ## Add some intents
 
 You need to associate some patterns with the `IntentRecognizer` by calling `AddIntent()`.
-We will add 2 intents with the same ID for changing floors, and another intent with a separate ID for opening and closing doors.
+We'll add two intents with the same ID for changing floors, and another intent with a separate ID for opening and closing doors.
 
 ```cpp
     intentRecognizer->AddIntent("Take me to floor {floorName}.", "ChangeFloors");
@@ -60,7 +59,7 @@ We will add 2 intents with the same ID for changing floors, and another intent w
 ```
 
 > [!NOTE]
-> There is no limit to the number of entities you can declare, but they will be loosely matched. If you add a phrase like "{action} door" it will match any time there is text before the word "door". Intents are evaluated based on their number of entities. If two patterns would match, the one with more defined entities is returned.
+> There's no limit to the number of entities you can declare, but they'll be loosely matched. If you add a phrase like "{action} door", it matches any time there's text before the word "door". Intents are evaluated based on their number of entities. If two patterns would match, the one with more defined entities is returned.
 
 ## Recognize an intent
 
@@ -75,7 +74,7 @@ Insert this code below your intents:
 
 ## Display the recognition results (or errors)
 
-When the recognition result is returned by the Speech service, we will print the result.
+When the Speech service returns the recognition result, we print the result.
 
 Insert this code below `auto result = intentRecognizer->RecognizeOnceAsync().get();`:
 
@@ -222,7 +221,7 @@ Now you're ready to build your app and test our speech recognition using the Spe
 
 1. **Compile the code** - From the menu bar of Visual Studio, choose **Build** > **Build Solution**.
 2. **Start your app** - From the menu bar, choose **Debug** > **Start Debugging** or press <kbd>F5</kbd>.
-3. **Start recognition** - It will prompt you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
+3. **Start recognition** - It prompts you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
 
 For example if you say "Take me to floor 7", this should be the output:
 
diff --git a/articles/ai-services/speech-service/includes/how-to/intent-recognition/csharp/pattern-matching.md b/articles/ai-services/speech-service/includes/how-to/intent-recognition/csharp/pattern-matching.md
@@ -5,7 +5,6 @@ ms.service: azure-ai-speech
 ms.date: 11/15/2021
 ms.topic: include
 ms.author: ralphe
-zone_pivot_groups: programming-languages-set-two
 ---
 
 ## Create a project
@@ -62,7 +61,7 @@ using (var recognizer = new IntentRecognizer(config))
 ## Add some intents
 
 You need to associate some patterns with a `PatternMatchingModel` and apply it to the `IntentRecognizer`.
-We will start by creating a `PatternMatchingModel` and adding a few intents to it.
+We'll start by creating a `PatternMatchingModel` and adding a few intents to it.
 
 > [!Note]
 > We can add multiple patterns to a `PatternMatchingIntent`.
@@ -93,7 +92,7 @@ model.Intents.Add(new PatternMatchingIntent("DoorControl", "{action} the doors",
 
 ## Add some custom entities
 
-To take full advantage of the pattern matcher you can customize your entities. We will make "floorName" a list of the available floors. We will also make "parkingLevel" an integer entity.
+To take full advantage of the pattern matcher, you can customize your entities. We'll make "floorName" a list of the available floors. We'll also make "parkingLevel" an integer entity.
 
 Insert this code below your intents:
 
@@ -109,7 +108,7 @@ model.Entities.Add(PatternMatchingEntity.CreateIntegerEntity("parkingLevel"));
 
 ## Apply our model to the Recognizer
 
-Now it is necessary to apply the model to the `IntentRecognizer`. It is possible to use multiple models at once so the API takes a collection of models.
+Now it's necessary to apply the model to the `IntentRecognizer`. It's possible to use multiple models at once so the API takes a collection of models.
 
 Insert this code below your entities:
 
@@ -134,7 +133,7 @@ var result = await recognizer.RecognizeOnceAsync();
 
 ## Display the recognition results (or errors)
 
-When the recognition result is returned by the Speech service, we will print the result.
+When the Speech service returns the recognition result, we print the result.
 
 Insert this code below `var result = await recognizer.RecognizeOnceAsync();`:
 
@@ -335,7 +334,7 @@ Now you're ready to build your app and test our speech recognition using the Spe
 
 1. **Compile the code** - From the menu bar of Visual Studio, choose **Build** > **Build Solution**.
 2. **Start your app** - From the menu bar, choose **Debug** > **Start Debugging** or press <kbd>F5</kbd>.
-3. **Start recognition** - It will prompt you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
+3. **Start recognition** - It prompts you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
 
 For example if you say "Take me to floor 2", this should be the output:
 
@@ -354,4 +353,4 @@ RECOGNIZED: Text=Take me to floor 7.
     Intent not recognized.
 ```
 
-No intent was recognized because 7 was not in our list of valid values for floorName.
+No intent was recognized because 7 wasn't in our list of valid values for floorName.
diff --git a/articles/ai-services/speech-service/includes/how-to/intent-recognition/csharp/simple-pattern-matching.md b/articles/ai-services/speech-service/includes/how-to/intent-recognition/csharp/simple-pattern-matching.md
@@ -5,7 +5,6 @@ ms.service: azure-ai-speech
 ms.date: 01/03/2022
 ms.topic: include
 ms.author: chschrae
-zone_pivot_groups: programming-languages-set-two
 ---
 
 ## Create a project
@@ -62,7 +61,7 @@ using (var intentRecognizer = new IntentRecognizer(config))
 ## Add some intents
 
 You need to associate some patterns with the `IntentRecognizer` by calling `AddIntent()`.
-We will add 2 intents with the same ID for changing floors, and another intent with a separate ID for opening and closing doors.
+We'll add two intents with the same ID for changing floors, and another intent with a separate ID for opening and closing doors.
 Insert this code inside the `using` block:
 
 ```C#
@@ -72,7 +71,7 @@ intentRecognizer.AddIntent("{action} the door.", "OpenCloseDoor");
 ```
 
 > [!NOTE]
-> There is no limit to the number of entities you can declare, but they will be loosely matched. If you add a phrase like "{action} door" it will match any time there is text before the word "door". Intents are evaluated based on their number of entities. If two patterns would match, the one with more defined entities is returned.
+> There's no limit to the number of entities you can declare, but they'll be loosely matched. If you add a phrase like "{action} door", it matches any time there's text before the word "door". Intents are evaluated based on their number of entities. If two patterns would match, the one with more defined entities is returned.
 
 ## Recognize an intent
 
@@ -88,7 +87,7 @@ var result = await intentRecognizer.RecognizeOnceAsync();
 
 ## Display the recognition results (or errors)
 
-When the recognition result is returned by the Speech service, we will print the result.
+When the Speech service returns the recognition result, we print the result.
 
 Insert this code below `var result = await recognizer.RecognizeOnceAsync();`:
 
@@ -256,7 +255,7 @@ Now you're ready to build your app and test our speech recognition using the Spe
 
 1. **Compile the code** - From the menu bar of Visual Studio, choose **Build** > **Build Solution**.
 2. **Start your app** - From the menu bar, choose **Debug** > **Start Debugging** or press <kbd>F5</kbd>.
-3. **Start recognition** - It will prompt you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
+3. **Start recognition** - It prompts you to say something. The default language is English. Your speech is sent to the Speech service, transcribed as text, and rendered in the console.
 
 For example if you say "Take me to floor 7", this should be the output:
 
diff --git a/zone-pivots/zone-pivot-groups.yml b/zone-pivots/zone-pivot-groups.yml
