Merge pull request #112684 from msebolt/1705897-adding-zone-pivots-cognitive-services-content-moderator

tfosmark · web-flow · commit 5ddcf64cce20 · 2020-04-24T16:08:08.000-07:00
initial draft
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -672,6 +672,21 @@
       "redirect_url": "/azure/machine-learning/samples-notebooks",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/cognitive-services/Content-Moderator/dotnet-sdk-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/Content-Moderator/client-libraries?pivots=programming-language-csharp",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Content-Moderator/java-sdk-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/Content-Moderator/client-libraries?pivots=programming-language-java",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Content-Moderator/python-sdk-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/Content-Moderator/client-libraries?pivots=programming-language-python",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/cognitive-services/QnAMaker/Tutorials/create-publish-query-in-portal.md",
       "redirect_url": "/azure/cognitive-services/QnAMaker/Quickstarts/create-publish-knowledge-base",
diff --git a/articles/cognitive-services/Content-Moderator/client-libraries.md b/articles/cognitive-services/Content-Moderator/client-libraries.md
@@ -0,0 +1,34 @@
+---
+title: 'Quickstart: Use the Content Moderator client library'
+titleSuffix: Azure Cognitive Services
+description: The Content Moderator API offers client libraries that makes it easy to integrate Content Moderator into your applications.
+services: cognitive-services
+author: PatrickFarley
+manager: nitinme
+zone_pivot_groups: programming-languages-set-eleven
+
+ms.service: cognitive-services
+ms.subservice: content-moderator
+ms.topic: quickstart
+ms.date: 04/24/2020
+ms.author: pafarley
+---
+# Quickstart: Use the Content Moderator client library
+
+::: zone pivot="programming-language-csharp"
+
+[!INCLUDE [C# quickstart](includes/quickstarts/content-moderator-client-library-csharp.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-java"
+
+[!INCLUDE [Java quickstart](includes/quickstarts/content-moderator-client-library-java.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-python"
+
+[!INCLUDE [Python quickstart](includes/quickstarts/content-moderator-client-library-python.md)]
+
+::: zone-end
diff --git a/articles/cognitive-services/Content-Moderator/includes/quickstarts/content-moderator-client-library-csharp.md b/articles/cognitive-services/Content-Moderator/includes/quickstarts/content-moderator-client-library-csharp.md
@@ -1,5 +1,5 @@
 ---
-title: "Quickstart: Content Moderator client library for .NET"
+title: "Content Moderator .NET client library quickstart"
 titleSuffix: Azure Cognitive Services
 description: Get started with the Content Moderator client library for .NET with this quickstart.
 services: cognitive-services
@@ -12,8 +12,6 @@ ms.date: 01/27/2020
 ms.author: pafarley
 ---
 
-# Quickstart: Content Moderator client library for .NET
-
 Get started with the Content Moderator client library for .NET. Follow these steps to install the package and try out the example code for basic tasks. Content Moderator is a cognitive service that checks text, image, and video content for material that is potentially offensive, risky, or otherwise undesirable. When such material is found, the service applies appropriate labels (flags) to the content. Your app can then handle flagged content to comply with regulations or maintain the intended environment for users.
 
 Use the Content Moderator client library for .NET to:
@@ -89,7 +87,7 @@ If you're using the Visual Studio IDE, the client library is available as a down
 
 ## Object model
 
-The following classes handle some of the major features of the Content Moderator .NET SDK.
+The following classes handle some of the major features of the Content Moderator .NET client library.
 
 |Name|Description|
 |---|---|
@@ -175,7 +173,7 @@ The following method iterates through the image URLs in a text file, creates an
 
 #### Analyze content
 
-For more information on the image attributes that Content Moderator screens for, see the [Image moderation concepts](./image-moderation-api.md) guide.
+For more information on the image attributes that Content Moderator screens for, see the [Image moderation concepts](../../image-moderation-api.md) guide.
 
 [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/ContentModerator/Program.cs?name=snippet_imagemod_analyze)]
 
@@ -185,7 +183,7 @@ For more information on the image attributes that Content Moderator screens for,
 
 ## Create a review
 
-You can use the Content Moderator .NET SDK to feed content into the [Review tool](https://contentmoderator.cognitive.microsoft.com) so that human moderators can review it. To learn more about the Review tool, see the [Review tool conceptual guide](./review-tool-user-guide/human-in-the-loop.md).
+You can use the Content Moderator .NET client library to feed content into the [Review tool](https://contentmoderator.cognitive.microsoft.com) so that human moderators can review it. To learn more about the Review tool, see the [Review tool conceptual guide](../../review-tool-user-guide/human-in-the-loop.md).
 
 The method in this section uses the [Reviews](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.contentmoderator.reviews?view=azure-dotnet) class to create a review, retrieve its ID, and check its details after receiving human input through the Review tool's web portal. It logs all of this information in an output text file. Call the method from your `Main` method:
 
@@ -265,8 +263,8 @@ dotnet run
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
-* [Portal](../cognitive-services-apis-create-account.md#clean-up-resources)
-* [Azure CLI](../cognitive-services-apis-create-account-cli.md#clean-up-resources)
+* [Portal](../../../cognitive-services-apis-create-account.md#clean-up-resources)
+* [Azure CLI](../../../cognitive-services-apis-create-account-cli.md#clean-up-resources)
 
 ## Next steps
 
@@ -275,5 +273,5 @@ In this quickstart, you learned how to use the Content Moderator .NET library to
 > [!div class="nextstepaction"]
 > [Image moderation concepts](https://docs.microsoft.com/azure/cognitive-services/content-moderator/image-moderation-api)
 
-* [What is Azure Content Moderator?](./overview.md)
+* [What is Azure Content Moderator?](../../overview.md)
 * The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/dotnet/ContentModerator/Program.cs).
diff --git a/articles/cognitive-services/Content-Moderator/includes/quickstarts/content-moderator-client-library-java.md b/articles/cognitive-services/Content-Moderator/includes/quickstarts/content-moderator-client-library-java.md
@@ -1,19 +1,17 @@
 ---
-title: "Quickstart: Content Moderator client library for Java"
+title: "Content Moderator Java client library quickstart"
 titleSuffix: Azure Cognitive Services
 description: In this quickstart, learn how to get started with the Azure Cognitive Services Content Moderator client library for Java.
 services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: content-moderator
-ms.topic: quickstart
+ms.topic: include
 ms.date: 01/27/2020
 ms.author: pafarley
 ---
 
-# Quickstart: Content Moderator client library for Java
-
 Get started with the Content Moderator client library for Java. Follow these steps to install the package and try out the example code for basic tasks. Content Moderator is a cognitive service that checks text, image, and video content for material that is potentially offensive, risky, or otherwise undesirable. When such material is found, the service applies appropriate labels (flags) to the content. Your app can then handle flagged content in order to comply with regulations or maintain the intended environment for users.
 
 Use the Content Moderator client library for Java to:
@@ -54,7 +52,7 @@ gradle init --type basic
 
 When prompted to choose a build script DSL, select **Kotlin**.
 
-Find *build.gradle.kts* and open it with your preferred IDE or text editor. Then copy in the following build configuration. This configuration defines the project as a Java application whose entry point is the class **ContentModeratorQuickstart**. It imports the Content Moderator SDK as well as the Gson sdk for JSON serialization.
+Find *build.gradle.kts* and open it with your preferred IDE or text editor. Then copy in the following build configuration. This configuration defines the project as a Java application whose entry point is the class **ContentModeratorQuickstart**. It imports the Content Moderator client library as well as the Gson sdk for JSON serialization.
 
 ```kotlin
 plugins {
@@ -88,7 +86,7 @@ Then create a file named *ContentModeratorQuickstart.java* in the new folder. Op
 
 ## Object model
 
-The following classes handle some of the major features of the Content Moderator Java SDK.
+The following classes handle some of the major features of the Content Moderator Java client library.
 
 |Name|Description|
 |---|---|
@@ -189,8 +187,8 @@ Then navigate to the *src/main/resources/ModerationOutput.json* file and view th
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
-* [Portal](../cognitive-services-apis-create-account.md#clean-up-resources)
-* [Azure CLI](../cognitive-services-apis-create-account-cli.md#clean-up-resources)
+* [Portal](../../../cognitive-services-apis-create-account.md#clean-up-resources)
+* [Azure CLI](../../../cognitive-services-apis-create-account-cli.md#clean-up-resources)
 
 ## Next steps
 
@@ -199,5 +197,5 @@ In this quickstart, you learned how to use the Content Moderator Java library to
 > [!div class="nextstepaction"]
 >[Image moderation concepts](https://docs.microsoft.com/azure/cognitive-services/content-moderator/image-moderation-api)
 
-* [What is Azure Content Moderator?](./overview.md)
+* [What is Azure Content Moderator?](../../overview.md)
 * The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/java/ContentModerator/src/main/java/ContentModeratorQuickstart.java).
diff --git a/articles/cognitive-services/Content-Moderator/includes/quickstarts/content-moderator-client-library-python.md b/articles/cognitive-services/Content-Moderator/includes/quickstarts/content-moderator-client-library-python.md
@@ -1,19 +1,17 @@
 ---
-title: "Quickstart: Content Moderator client library for Python"
+title: "Content Moderator Python client library quickstart"
 titleSuffix: Azure Cognitive Services
 description: In this quickstart, learn how to get started with the Azure Cognitive Services Content Moderator client library for Python.
 services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: content-moderator
-ms.topic: quickstart
+ms.topic: include
 ms.date: 01/27/2020
 ms.author: pafarley
 ---
 
-# Quickstart: Content Moderator client library for Python
-
 Get started with the Content Moderator client library for Python. Follow these steps to install the package and try out the example code for basic tasks. Content Moderator is a cognitive service that checks text, image, and video content for material that is potentially offensive, risky, or otherwise undesirable. When such material is found, the service applies appropriate labels (flags) to the content. Your app can then handle flagged content in order to comply with regulations or maintain the intended environment for users.
 
 Use the Content Moderator client library for Python to:
@@ -65,7 +63,7 @@ pip install --upgrade azure-cognitiveservices-vision-contentmoderator
 
 ## Object model
 
-The following classes handle some of the major features of the Content Moderator Python SDK.
+The following classes handle some of the major features of the Content Moderator Python client library.
 
 |Name|Description|
 |---|---|
@@ -88,7 +86,7 @@ These code snippets show you how to do the following tasks with the Content Mode
 ## Authenticate the client
 
 > [!NOTE]
-> This quickstart assumes you've [created environment variables](../cognitive-services-apis-create-account.md#configure-an-environment-variable-for-authentication) for your Content Moderator key and endpoint.
+> This quickstart assumes you've [created environment variables](../../../cognitive-services-apis-create-account.md#configure-an-environment-variable-for-authentication) for your Content Moderator key and endpoint.
 
 Instantiate a client with your endpoint and key. Create a [CognitiveServicesCredentials](https://docs.microsoft.com/python/api/msrest/msrest.authentication.cognitiveservicescredentials?view=azure-python) object with your key, and use it with your endpoint to create an [ContentModeratorClient](https://docs.microsoft.com/python/api/azure-cognitiveservices-vision-contentmoderator/azure.cognitiveservices.vision.contentmoderator.content_moderator_client.contentmoderatorclient?view=azure-python) object.
 
@@ -197,7 +195,7 @@ Then add the following code to iterate through your images. The rest of the code
 
 ### Check for adult/racy content
 
-The following code checks the image at the given URL for adult or racy content and prints results to the console. See the [Image moderation concepts](./image-moderation-api.md) guide for information on what these terms mean.
+The following code checks the image at the given URL for adult or racy content and prints results to the console. See the [Image moderation concepts](../../image-moderation-api.md) guide for information on what these terms mean.
 
 [!code-python[](~/cognitive-services-quickstart-code/python/ContentModerator/ContentModeratorQuickstart.py?name=snippet_imagemod_ar)]
 
@@ -291,7 +289,7 @@ Use the following code to delete a given image list.
 
 ## Create a review
 
-You can use the Content Moderator Python SDK to feed content into the [Review tool](https://contentmoderator.cognitive.microsoft.com) so that human moderators can review it. To learn more about the Review tool, see the [Review tool conceptual guide](./review-tool-user-guide/human-in-the-loop.md).
+You can use the Content Moderator Python client library to feed content into the [Review tool](https://contentmoderator.cognitive.microsoft.com) so that human moderators can review it. To learn more about the Review tool, see the [Review tool conceptual guide](../../review-tool-user-guide/human-in-the-loop.md).
 
 The following code uses the [ReviewsOperations](https://docs.microsoft.com/python/api/azure-cognitiveservices-vision-contentmoderator/azure.cognitiveservices.vision.contentmoderator.operations.reviewsoperations?view=azure-python) class to create a review, retrieve its ID, and check its details after receiving human input through the Review tool's web portal.
 
@@ -340,8 +338,8 @@ python quickstart-file.py
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
-* [Portal](../cognitive-services-apis-create-account.md#clean-up-resources)
-* [Azure CLI](../cognitive-services-apis-create-account-cli.md#clean-up-resources)
+* [Portal](../../../cognitive-services-apis-create-account.md#clean-up-resources)
+* [Azure CLI](../../../cognitive-services-apis-create-account-cli.md#clean-up-resources)
 
 ## Next steps
 
@@ -350,5 +348,5 @@ In this quickstart, you learned how to use the Content Moderator Python library
 > [!div class="nextstepaction"]
 >[Image moderation concepts](https://docs.microsoft.com/azure/cognitive-services/content-moderator/image-moderation-api)
 
-* [What is Azure Content Moderator?](./overview.md)
+* [What is Azure Content Moderator?](../../overview.md)
 * The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/python/ContentModerator/ContentModeratorQuickstart.py).
diff --git a/articles/cognitive-services/Content-Moderator/index.yml b/articles/cognitive-services/Content-Moderator/index.yml
@@ -40,11 +40,11 @@ landingContent:
       - linkListType: quickstart
         links:
           - text: Using the .NET SDK
-            url: dotnet-sdk-quickstart.md
+            url: client-libraries.md?pivots=programming-language-csharp
           - text: Using the Python SDK
-            url: python-sdk-quickstart.md
+            url: client-libraries.md?pivots=programming-language-python
           - text: Using the Java SDK
-            url: java-sdk-quickstart.md
+            url: client-libraries.md?pivots=programming-language-java
       - linkListType: how-to-guide
         links:
           - text: Using the API console
diff --git a/articles/cognitive-services/Content-Moderator/toc.yml b/articles/cognitive-services/Content-Moderator/toc.yml
@@ -10,14 +10,8 @@
   items:
   - name: Try Content Moderator on web
     href: quick-start.md
-  - name: Using the client SDK
-    items:
-    - name: Using the .NET SDK
-      href: dotnet-sdk-quickstart.md
-    - name: Using the Python SDK
-      href: python-sdk-quickstart.md
-    - name: Using the Java SDK
-      href: java-sdk-quickstart.md
+  - name: Using the client library
+    href: client-libraries.md
 - name: Tutorials
   items:
   - name: Moderate e-commerce images
