Merge pull request #106836 from john-par/1678688-adding-zone-pivots-bing-entity-search

1678688, adding zone pivots bing entity search.

Author: GitHubber17

.openpublishing.redirection.json

@@ -1720,6 +1720,26 @@
       "redirect_url": "/azure/cognitive-services/bing-image-search/quickstarts/client-libraries?pivots=programming-language-python",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-csharp-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/bing-entity-search/quickstarts/client-libraries?pivots=programming-language-csharp",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-java-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/bing-entity-search/quickstarts/client-libraries?pivots=programming-language-java",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-node-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/bing-entity-search/quickstarts/client-libraries?pivots=programming-language-javascript",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-python-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/bing-entity-search/quickstarts/client-libraries?pivots=programming-language-python",
+      "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/Bing-Entities-Search/quickstarts/entity-sdk-csharp-quickstart.md renamed to articles/cognitive-services/Bing-Entities-Search/includes/quickstarts/entity-search-client-library-csharp.md

@@ -1,21 +1,16 @@
 ---
-title: "Quickstart: Search for entities with the SDK for C# - Bing Entity Search"
+title: Bing Entity Search C# client library quickstart 
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to search for entities with the Bing Entity Search SDK for C#.
 services: cognitive-services
 author: aahill
 manager: nitinme
-
 ms.service: cognitive-services
-ms.subservice: bing-entity-search
-ms.topic: quickstart
-ms.date: 12/11/2019
+ms.topic: include
+ms.date: 03/06/2020
 ms.author: aahi
 ---
 
-# Send a search request with the Bing Entity Search SDK for C#
-
-Use this quickstart to begin searching for entities with the Bing Entity Search SDK for C#. While Bing Entity Search has a REST API compatible with most programming languages, the SDK provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples/tree/master/BingSearchv7/BingEntitySearch).
+Use this quickstart to begin searching for entities with the Bing Entity Search client library for C#. While Bing Entity Search has a REST API compatible with most programming languages, the client library provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples/tree/master/BingSearchv7/BingEntitySearch).
 
 
 ## Prerequisites
@@ -28,10 +23,10 @@ Use this quickstart to begin searching for entities with the Bing Entity Search
     * Microsoft.Rest.ClientRuntime.Azure
     * Newtonsoft.Json
 
-To add the Bing Entity Search SDK to your Visual Studio project, use the **Manage NuGet Packages** option from **Solution Explorer**, and add the `Microsoft.Azure.CognitiveServices.Search.EntitySearch` package.
+To add the Bing Entity Search client library to your Visual Studio project, use the **Manage NuGet Packages** option from **Solution Explorer**, and add the `Microsoft.Azure.CognitiveServices.Search.EntitySearch` package.
 
 
-[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-entity-search-signup-requirements.md)]
+[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](~/includes/cognitive-services-bing-entity-search-signup-requirements.md)]
 
 ## Create and initialize an application
 
@@ -77,6 +72,6 @@ To add the Bing Entity Search SDK to your Visual Studio project, use the **Manag
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Create a single-page web app](../tutorial-bing-entities-search-single-page-app.md)
+> [Create a single-page web app](../../tutorial-bing-entities-search-single-page-app.md)
 
-* [What is the Bing Entity Search API?](../overview.md )
+* [What is the Bing Entity Search API?](../../overview.md )

articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-java-quickstart.md renamed to articles/cognitive-services/Bing-Entities-Search/includes/quickstarts/entity-search-client-library-java.md

@@ -1,28 +1,24 @@
 ---
-title: "Quickstart: Search for entities with the SDK for Java - Bing Entity Search"
+title: Bing Entity Search Java client library quickstart 
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to search for entities with the Bing Entity Search SDK for Java
 services: cognitive-services
 author: aahill
 manager: nitinme
-
 ms.service: cognitive-services
-ms.subservice: bing-entity-search
-ms.topic: quickstart
-ms.date: 12/11/2019
+ms.topic: include
+ms.date: 03/06/2020
 ms.author: aahi
 ---
-# Quickstart: Send a search request with the Bing Entity Search SDK for Java
 
-Use this quickstart to begin searching for entities with the Bing Entity Search SDK for Java. While Bing Entity Search has a REST API compatible with most programming languages, the SDK provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-java-sdk-samples/tree/master/Search/BingEntitySearch).
+Use this quickstart to begin searching for entities with the Bing Entity Search client library for Java. While Bing Entity Search has a REST API compatible with most programming languages, the client library provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-java-sdk-samples/tree/master/Search/BingEntitySearch).
 
 ## Prerequisites
 
 * The [Java Development Kit(JDK)](https://www.oracle.com/technetwork/java/javase/downloads/)
 
-* The Bing Entity Search SDK for Java
+* The Bing Entity Search client library for Java
 
-Install the Bing Entity Search SDK dependencies by using Maven, Gradle, or another dependency management system. The Maven POM file requires the declaration:
+Install the Bing Entity Search client library dependencies by using Maven, Gradle, or another dependency management system. The Maven POM file requires the declaration:
 
 ```xml
 <dependency>
@@ -32,7 +28,7 @@ Install the Bing Entity Search SDK dependencies by using Maven, Gradle, or anoth
 </dependency>
 ```
 
-[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-entity-search-signup-requirements.md)]
+[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](~/includes/cognitive-services-bing-entity-search-signup-requirements.md)]
 
 
 ## Create and initialize a project
@@ -62,7 +58,7 @@ Install the Bing Entity Search SDK dependencies by using Maven, Gradle, or anoth
 
 ## Create a search client
 
-1. Implement the `dominantEntityLookup` client, which requires your API endpoint, and an instance of the `ServiceClientCredentials` class. You can use the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+1. Implement the `dominantEntityLookup` client, which requires your API endpoint, and an instance of the `ServiceClientCredentials` class. You can use the global endpoint below, or the [custom subdomain](../../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
     ```java
     public static EntitySearchAPIImpl getClient(final String subscriptionKey) {
@@ -115,7 +111,7 @@ Install the Bing Entity Search SDK dependencies by using Maven, Gradle, or anoth
        }
        //...
        ```
-      ## Send a request and receive a response
+## Send a request and receive a response
 
 1. Create a new instance of the search client with your subscription key. use `client.entities().search()` to send a search request for the search query `satya nadella`, and get a response. 
 
@@ -145,6 +141,6 @@ Install the Bing Entity Search SDK dependencies by using Maven, Gradle, or anoth
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Build a single-page web app](../tutorial-bing-entities-search-single-page-app.md)
+> [Build a single-page web app](../../tutorial-bing-entities-search-single-page-app.md)
 
-* [What is the Bing Entity Search API?](../overview.md )
+* [What is the Bing Entity Search API?](../../overview.md)

articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-node-quickstart.md renamed to articles/cognitive-services/Bing-Entities-Search/includes/quickstarts/entity-search-client-library-javascript.md

@@ -1,21 +1,16 @@
 ---
-title: "Quickstart: Send a search request with the SDK for Node.js - Bing Entity Search"
+title: Bing Entity Search JavaScript client library quickstart 
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to search for entities with the Bing Entity Search SDK for Node.js
 services: cognitive-services
 author: aahill
 manager: nitinme
-
 ms.service: cognitive-services
-ms.subservice: bing-entity-search
-ms.topic: quickstart
-ms.date: 01/22/2020
+ms.topic: include
+ms.date: 03/06/2020
 ms.author: aahi
 ---
 
-# Quickstart: Send a search request with the Bing Entity Search SDK for Node.js
-
-Use this quickstart to begin searching for entities with the Bing Entity Search SDK for Node.js. While Bing Entity Search has a REST API compatible with most programming languages, the SDK provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-node-sdk-samples/blob/master/Samples/entitySearch.js).
+Use this quickstart to begin searching for entities with the Bing Entity Search client library for JavaScript. While Bing Entity Search has a REST API compatible with most programming languages, the client library provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-node-sdk-samples/blob/master/Samples/entitySearch.js).
 
 ## Prerequisites
 
@@ -28,7 +23,7 @@ To install the Bing Entity Search SDK:
 1. Run `npm install ms-rest-azure` in your development environment.
 2. Run `npm install @azure/cognitiveservices-entitysearch` in your development environment.
 
-[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-entity-search-signup-requirements.md)]
+[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](~/includes/cognitive-services-bing-entity-search-signup-requirements.md)]
 
 
 ## Create and initialize the application
@@ -68,6 +63,6 @@ To install the Bing Entity Search SDK:
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Create a single-page web app](../tutorial-bing-entities-search-single-page-app.md)
+> [Create a single-page web app](../../tutorial-bing-entities-search-single-page-app.md)
 
-* [What is the Bing Entity Search API?](../overview.md )
+* [What is the Bing Entity Search API?](../../overview.md)

articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-python-quickstart.md renamed to articles/cognitive-services/Bing-Entities-Search/includes/quickstarts/entity-search-client-library-python.md

@@ -1,20 +1,16 @@
 ---
-title: "Quickstart: Search for entities with the SDK for Python - Bing Entity Search"
+title: Bing Entity Search Python client library quickstart 
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to search for entities with the Bing Entity Search SDK for Python.
 services: cognitive-services
 author: aahill
 manager: nitinme
-
 ms.service: cognitive-services
-ms.subservice: bing-entity-search
-ms.topic: quickstart
-ms.date: 02/11/2020
+ms.topic: include
+ms.date: 03/06/2020
 ms.author: aahi
 ---
-# Quickstart: Bing Entity Search SDK with Python
 
-Use this quickstart to begin searching for entities with the Bing Entity Search SDK for Python. While Bing Entity Search has a REST API compatible with most programming languages, the SDK provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-python-sdk-samples/blob/master/samples/search/entity_search_samples.py).
+Use this quickstart to begin searching for entities with the Bing Entity Search client library for Python. While Bing Entity Search has a REST API compatible with most programming languages, the client library provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-python-sdk-samples/blob/master/samples/search/entity_search_samples.py).
 
 ## Prerequisites
 
@@ -28,14 +24,14 @@ It is recommended that you use a python virtual environment. You can install and
 python -m venv mytestenv
 ```
 
-Install the Bing Entity Search SDK with:
+Install the Bing Entity Search client library with:
 
 ```Console
 cd mytestenv
 python -m pip install azure-cognitiveservices-search-entitysearch
 ```
 
-[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-entity-search-signup-requirements.md)]
+[!INCLUDE [cognitive-services-bing-news-search-signup-requirements](~/includes/cognitive-services-bing-entity-search-signup-requirements.md)]
 
 ## Create and initialize the application
 
@@ -77,6 +73,6 @@ python -m pip install azure-cognitiveservices-search-entitysearch
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Create a single-page web app](../tutorial-bing-entities-search-single-page-app.md)
+> [Create a single-page web app](../../tutorial-bing-entities-search-single-page-app.md)
 
-* [What is the Bing Entity Search API?](../overview.md )
+* [What is the Bing Entity Search API?](../../overview.md )

articles/cognitive-services/Bing-Entities-Search/quickstarts/client-libraries.md

@@ -0,0 +1,40 @@
+---
+title: 'Quickstart: Use the Bing Entity Search client library'
+titleSuffix: Azure Cognitive Services
+description: The Entity Search API offers client libraries that makes it easy to integrate search capabilities into your applications. Use this quickstart to start sending search requests, and get back results.
+services: cognitive-services
+author: aahill
+manager: nitinme
+zone_pivot_groups: programming-languages-set-ten
+
+ms.service: cognitive-services
+ms.subservice: bing-entity-search
+ms.topic: quickstart
+ms.date: 03/06/2020
+ms.author: aahi
+---
+# Quickstart: Use the Bing Entity Search client library
+
+::: zone pivot="programming-language-csharp"
+
+[!INCLUDE [C# quickstart](../includes/quickstarts/entity-search-client-library-csharp.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-java"
+
+[!INCLUDE [Java quickstart](../includes/quickstarts/entity-search-client-library-java.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-javascript"
+
+[!INCLUDE [JavaScript quickstart](../includes/quickstarts/entity-search-client-library-javascript.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-python"
+
+[!INCLUDE [Python quickstart](../includes/quickstarts/entity-search-client-library-python.md)]
+
+::: zone-end

articles/cognitive-services/Bing-Entities-Search/toc.yml

@@ -26,14 +26,8 @@
         href: quickstarts/ruby.md
     - name: SDK
       items:
-      - name: Using C# 
-        href: quickstarts/entity-sdk-csharp-quickstart.md
-      - name: Using Node.js
-        href: quickstarts/entity-sdk-node-quickstart.md  
-      - name: Using Python
-        href: quickstarts/entity-sdk-python-quickstart.md 
-      - name: Using Java
-        href: quickstarts/entity-sdk-java-quickstart.md
+      - name: Bing Entity Search client libraries
+        href: ./quickstarts/client-libraries.md
 - name: Tutorials
   items:
   - name: Build a single-page web app

articles/cognitive-services/Bing-Web-Search/index.yml

@@ -106,16 +106,16 @@ conceptualContent:
       links:
         - text: Use C#
           itemType: quickstart
-          url: ../bing-entities-search/quickstarts/entity-sdk-csharp-quickstart.md
+          url: ../bing-entities-search/quickstarts/client-libraries.md?pivots=programming-language-csharp
         - text: Use Java
           itemType: quickstart
-          url: ../bing-entities-search/quickstarts/entity-sdk-java-quickstart.md
-        - text: Use Node.js
+          url: ../bing-entities-search/quickstarts/client-libraries.md?pivots=programming-language-java
+        - text: Use JavaScript
           itemType: quickstart
-          url: ../bing-entities-search/quickstarts/entity-sdk-node-quickstart.md
+          url: ../bing-entities-search/quickstarts/client-libraries.md?pivots=programming-language-javascript
         - text: Use Python
           itemType: quickstart
-          url: ../bing-entities-search/quickstarts/entity-sdk-python-quickstart.md
+          url: ../bing-entities-search/quickstarts/client-libraries.md?pivots=programming-language-python
         - text: Create a single page web-app
           itemType: tutorial
           url: ../bing-entities-search/tutorial-bing-entities-search-single-page-app.md