zone-pivots

Author: Matthew Sebolt (Aquent LLC)

.openpublishing.redirection.json

@@ -1897,6 +1897,21 @@
       "redirect_url": "/azure/cognitive-services/bing-autosuggest/quickstarts/client-libraries?pivots=programming-language-go",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/cognitive-services/Face/Quickstarts/csharp-sdk.md",
+      "redirect_url": "/azure/cognitive-services/Face/Quickstarts/client-libraries?pivots=programming-language-csharp",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Face/Quickstarts/python-sdk.md",
+      "redirect_url": "/azure/cognitive-services/Face/Quickstarts/client-libraries?pivots=programming-language-python",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Face/Quickstarts/go-sdk.md",
+      "redirect_url": "/azure/cognitive-services/Face/Quickstarts/client-libraries?pivots=programming-language-go",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/virtual-machines/linux/classic/rdma-cluster.md",
       "redirect_url": "/azure/virtual-machines/linux/sizes-hpc#rdma-capable-instances",

articles/cognitive-services/Face/QuickStarts/client-libraries.md

@@ -0,0 +1,34 @@
+---
+title: 'Quickstart: Use the Face client library'
+titleSuffix: Azure Cognitive Services
+description: The Face API offers client libraries that makes it easy to detect, find similar, identify, verify and more.
+services: cognitive-services
+author: PatrickFarley
+manager: nitinme
+zone_pivot_groups: programming-languages-set-seventeen
+
+ms.service: cognitive-services
+ms.subservice: face-api
+ms.topic: quickstart
+ms.date: 04/24/2020
+ms.author: pafarley
+---
+# Quickstart: Use the Face client library
+
+::: zone pivot="programming-language-csharp"
+
+[!INCLUDE [C# quickstart](../includes/quickstarts/face-client-library-csharp.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-python"
+
+[!INCLUDE [Python quickstart](../includes/quickstarts/face-client-library-python.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-go"
+
+[!INCLUDE [Go quickstart](../includes/quickstarts/face-client-library-go.md)]
+
+::: zone-end

articles/cognitive-services/Face/QuickStarts/csharp-sdk.md renamed to articles/cognitive-services/Face/includes/quickstarts/face-client-library-csharp.md

@@ -1,17 +1,15 @@
 ---
-title: "Quickstart: Face client library for .NET"
+title: "Face .NET client library quickstart"
 description: Get started with the Face client library for .NET with this quickstart.
 services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
-ms.topic: quickstart
+ms.topic: include
 ms.date: 04/14/2020
 ms.author: pafarley
 ---
-# Quickstart: Face client library for .NET
-
 Get started with the Face client library for .NET. Follow these steps to install the package and try out the example code for basic tasks. The Face service provides you with access to advanced algorithms for detecting and recognizing human faces in images.
 
 Use the Face client library for .NET to:
@@ -83,7 +81,7 @@ If you're using the Visual Studio IDE, the client library is available as a down
 
 ## Object model
 
-The following classes and interfaces handle some of the major features of the Face .NET SDK:
+The following classes and interfaces handle some of the major features of the Face .NET client library:
 
 |Name|Description|
 |---|---|
@@ -285,8 +283,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)
 
 If you created a **PersonGroup** in this quickstart and you want to delete it, run the following code in your program:
 
@@ -307,5 +305,5 @@ In this quickstart, you learned how to use the Face library for .NET to do basis
 > [!div class="nextstepaction"]
 > [Face API reference (.NET)](https://docs.microsoft.com/dotnet/api/overview/azure/cognitiveservices/client/faceapi?view=azure-dotnet)
 
-* [What is the Face service?](../overview.md)
+* [What is the Face service?](../../overview.md)
 * The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples/blob/master/documentation-samples/quickstarts/Face/Program.cs).

articles/cognitive-services/Face/QuickStarts/go-sdk.md renamed to articles/cognitive-services/Face/includes/quickstarts/face-client-library-go.md

@@ -1,18 +1,15 @@
 ---
-title: "Quickstart: Face client library for Go | Microsoft Docs"
+title: "Face Go client library quickstart"
 description: Get started with the Face client library for Go.
 services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: 
-ms.topic: quickstart
+ms.topic: include
 ms.date: 01/27/2020
 ms.author: pafarley
 ---
-
-# Quickstart: Face client library for Go
-
 Get started with the Face client library for Go. Follow these steps to install the library and try out our examples for basic tasks. The Face service provides you with access to advanced algorithms for detecting and recognizing human faces in images.
 
 Use the Face service client library for Go to:
@@ -137,7 +134,7 @@ Next, you'll begin adding code to carry out different Face service operations.
 
 ## Object model
 
-The following classes and interfaces handle some of the major features of the Face service Go SDK.
+The following classes and interfaces handle some of the major features of the Face service Go client library.
 
 |Name|Description|
 |---|---|
@@ -354,8 +351,8 @@ go run sample-app.go
 
 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)
 
 If you created a **PersonGroup** in this quickstart and you want to delete it, call the **[Delete](https://godoc.org/github.com/Azure/azure-sdk-for-go/services/cognitiveservices/v1.0/face#PersonGroupClient.Delete)** method. If you migrated data using the Snapshot feature in this quickstart, you'll also need to delete the **PersonGroup** saved to the target subscription.
 
@@ -366,5 +363,5 @@ In this quickstart, you learned how to use the Face library for Go to do basis t
 > [!div class="nextstepaction"]
 > [Face API reference (Go)](https://godoc.org/github.com/Azure/azure-sdk-for-go/services/cognitiveservices/v1.0/face)
 
-* [What is the Face service?](../overview.md)
+* [What is the Face service?](../../overview.md)
 * The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/go/Face/FaceQuickstart.go).

articles/cognitive-services/Face/QuickStarts/python-sdk.md renamed to articles/cognitive-services/Face/includes/quickstarts/face-client-library-python.md

@@ -1,18 +1,15 @@
 ---
-title: "Quickstart: Face client library for Python"
+title: "Face Python client library quickstart"
 description: This quickstart will help you get started with the Face client library for Python to detect, find similar, identify, verify and more.
 services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
-ms.topic: quickstart
+ms.topic: include
 ms.date: 04/14/2020
 ms.author: pafarley
 ---
-
-# Quickstart: Face client library for Python
-
 Get started with the Face client library for Python. Follow these steps to install the package and try out the example code for basic tasks. The Face service provides you with access to advanced algorithms for detecting and recognizing human faces in images.
 
 Use the Face client library for Python to:
@@ -62,7 +59,7 @@ pip install --upgrade azure-cognitiveservices-vision-face
 
 ## Object model
 
-The following classes and interfaces handle some of the major features of the Face Python SDK.
+The following classes and interfaces handle some of the major features of the Face Python client library.
 
 |Name|Description|
 |---|---|
@@ -89,7 +86,7 @@ These code snippets show you how to do the following tasks with the Face client
 ## Authenticate the client
 
 > [!NOTE]
-> This quickstart assumes you've [created an environment variable](../../cognitive-services-apis-create-account.md#configure-an-environment-variable-for-authentication) for your Face key, named `FACE_SUBSCRIPTION_KEY`.
+> This quickstart assumes you've [created an environment variable](../../../cognitive-services-apis-create-account.md#configure-an-environment-variable-for-authentication) for your Face key, named `FACE_SUBSCRIPTION_KEY`.
 
 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 a [FaceClient](https://docs.microsoft.com/python/api/azure-cognitiveservices-vision-face/azure.cognitiveservices.vision.face.faceclient?view=azure-python) object.
 
@@ -109,7 +106,7 @@ The following code outputs the given image to the display and draws rectangles a
 
 [!code-python[](~/cognitive-services-quickstart-code/python/Face/FaceQuickstart.py?name=snippet_frame)]
 
-![A young woman with a red rectangle drawn around the face](../images/face-rectangle-result.png)
+![A young woman with a red rectangle drawn around the face](../../images/face-rectangle-result.png)
 
 ## Find similar faces
 
@@ -282,5 +279,5 @@ In this quickstart, you learned how to use the Face library for Python to do bas
 > [!div class="nextstepaction"]
 > [Face API reference (Python)](https://docs.microsoft.com/python/api/azure-cognitiveservices-vision-face/?view=azure-python)
 
-* [What is the Face service?](../overview.md)
+* [What is the Face service?](../../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/Face/FaceQuickstart.py).

articles/cognitive-services/Face/index.yml

@@ -37,11 +37,11 @@ landingContent:
       - linkListType: quickstart
         links:
           - text: Using the .NET SDK
-            url: quickstarts/csharp-sdk.md
+            url: quickstarts/client-libraries.md?pivots=programming-language-csharp
           - text: Using the Python SDK
-            url: quickstarts/python-sdk.md
+            url: quickstarts/client-libraries.md?pivots=programming-language-python
           - text: Using the Go SDK
-            url: quickstarts/go-sdk.md
+            url: quickstarts/client-libraries.md?pivots=programming-language-go
       - linkListType: how-to-guide
         links:
           - text: Specify a face detection model

articles/cognitive-services/Face/toc.yml

@@ -7,14 +7,8 @@
     href: Overview.md
 - name: Quickstarts
   items:
-  - name: Using the client SDK
-    items:
-    - name: .NET SDK
-      href: Quickstarts/csharp-sdk.md
-    - name: Python SDK
-      href: QuickStarts/python-sdk.md
-    - name: Go SDK
-      href: QuickStarts/go-sdk.md
+  - name: Using the client library
+    href: Quickstarts/client-libraries.md
   - name: Using the REST API  
     items:
     - name: Detect faces in an image  

articles/zone-pivot-groups.yml

@@ -295,4 +295,14 @@ groups:
   - id: programming-language-python
     title: Python
   - id: programming-language-more
-    title: More languages...
+    title: More languages...
+- id: programming-languages-set-seventeen
+  title: Programming languages
+  prompt: Choose a programming language
+  pivots:
+  - id: programming-language-csharp
+    title: C#
+  - id: programming-language-python
+    title: Python
+  - id: programming-language-go
+    title: Go