Merge pull request #96920 from HeidiSteen/heidist-master

GitHubber17 · web-flow · commit 56f6d6793d7d · 2019-11-22T09:26:09.000-08:00
MVC compliance pass for Azure Cognitive Search
diff --git a/articles/search/cognitive-search-quickstart-blob.md b/articles/search/cognitive-search-quickstart-blob.md
@@ -1,7 +1,7 @@
 ---
 title: 'Quickstart: Create a skillset in the Azure portal'
 titleSuffix: Azure Cognitive Search
-description: Use the Import data wizard to add cognitive skills to an indexing pipeline. Cognitive skills include Optical Character Recognition (OCR) and natural language processing.
+description: In this portal quickstart, learn how to use the Import data wizard to add cognitive skills to an indexing pipeline in Azure Cognitive Search. Skills include Optical Character Recognition (OCR) and natural language processing.
 
 manager: nitinme
 author: HeidiSteen
@@ -147,20 +147,20 @@ Output is directed to a search index, and there is a mapping between name-value
 
 Finally, you learned that can verify content by querying the index. In the end, what Azure Cognitive Search provides is a searchable index, which you can query using either the [simple](https://docs.microsoft.com/rest/api/searchservice/simple-query-syntax-in-azure-search) or [fully extended query syntax](https://docs.microsoft.com/rest/api/searchservice/lucene-query-syntax-in-azure-search). An index containing enriched fields is like any other. If you want to incorporate standard or [custom analyzers](search-analyzers.md), [scoring profiles](https://docs.microsoft.com/rest/api/searchservice/add-scoring-profiles-to-a-search-index), [synonyms](search-synonyms.md), [faceted filters](search-filters-facets.md), geo-search, or any other Azure Cognitive Search feature, you can certainly do so.
 
-## Clean up
+## Clean up resources
 
 When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
 
 You can find and manage resources in the portal, using the **All resources** or **Resource groups** link in the left-navigation pane.
 
 If you are using a free service, remember that you are limited to three indexes, indexers, and data sources. You can delete individual items in the portal to stay under the limit. 
 
+> [!Tip]
+> If you want to repeat this exercise or try a different AI enrichment walkthrough, delete the indexer in the portal. Deleting the indexer resets the free daily transaction counter back to zero for Cognitive Services processing.
+
 ## Next steps
 
 You can create skillsets using the portal, .NET SDK, or REST API. To further your knowledge, try the REST API using Postman and more sample data.
 
 > [!div class="nextstepaction"]
-> [Tutorial: Add structure to "unstructured content" with AI enrichment](cognitive-search-tutorial-blob.md)
-
-> [!Tip]
-> If you want to repeat this exercise or try a different AI enrichment walkthrough, delete the indexer in the portal. Deleting the indexer resets the free daily transaction counter back to zero for Cognitive Services processing.
+> [Tutorial: Add structure to "unstructured content" with AI enrichment](cognitive-search-tutorial-blob.md)
diff --git a/articles/search/cognitive-search-tutorial-blob-python.md b/articles/search/cognitive-search-tutorial-blob-python.md
@@ -4,8 +4,8 @@ titleSuffix: Azure Cognitive Search
 description: Step through an example of data extraction, natural language, and image AI processing in Azure Cognitive Search using a Jupyter Python notebook. Extracted data is indexed and easily accessed by query.
 
 manager: nitinme
-author: LisaLeib
-ms.author: v-lilei
+author: HeidiSteen
+ms.author: heidist
 ms.service: cognitive-search
 ms.devlang: python
 ms.topic: tutorial
diff --git a/articles/search/knowledge-store-connect-power-bi.md b/articles/search/knowledge-store-connect-power-bi.md
@@ -3,9 +3,9 @@ title: Connect to a knowledge store (preview) with Power BI
 titleSuffix: Azure Cognitive Search
 description: Connect an Azure Cognitive Search knowledge store (preview) with Power BI for analysis and exploration.
 
-author: lisaleib
+author: HeidiSteen
+ms.author: heidist
 manager: nitinme
-ms.author: v-lilei
 ms.service: cognitive-search
 ms.topic: tutorial
 ms.date: 11/04/2019
diff --git a/articles/search/knowledge-store-create-portal.md b/articles/search/knowledge-store-create-portal.md
@@ -3,9 +3,9 @@ title: Create a knowledge store (preview) in the Azure portal
 titleSuffix: Azure Cognitive Search
 description: Use the Import data wizard to create a knowledge store used for persisting enriched content. Connect to a knowledge store for analysis from other apps, or send enriched content to downstream processes. This feature is currently in public preview.
 
-author: lisaleib
+author: HeidiSteen
+ms.author: heidist
 manager: nitinme
-ms.author: v-lilei
 ms.service: cognitive-search
 ms.topic: quickstart
 ms.date: 11/04/2019
diff --git a/articles/search/knowledge-store-view-storage-explorer.md b/articles/search/knowledge-store-view-storage-explorer.md
@@ -4,8 +4,8 @@ titleSuffix: Azure Cognitive Search
 description: View and analyze an Azure Cognitive Search knowledge store with the Azure portal's Storage Explorer. knowledge store is currently in public preview.  
 
 manager: nitinme
-author: lisaleib
-ms.author: v-lilei
+author: HeidiSteen
+ms.author: heidist
 ms.service: cognitive-search
 ms.topic: conceptual
 ms.date: 11/04/2019
diff --git a/articles/search/search-create-service-portal.md b/articles/search/search-create-service-portal.md
@@ -1,7 +1,7 @@
 ---
 title: 'Quickstart: Create a search service in the portal'
 titleSuffix: Azure Cognitive Search
-description: Provision an AzureCognitive  Search resource in the Azure portal. Choose resource groups, regions, and SKU or pricing tier.
+description: In this portal quickstart, learn how to set up an Azure Cognitive Search resource in the Azure portal. Choose resource groups, regions, and SKU or pricing tier.
 
 manager: nitinme
 author: HeidiSteen
diff --git a/articles/search/search-filters.md b/articles/search/search-filters.md
@@ -98,7 +98,7 @@ The following examples illustrate several usage patterns for filter scenarios. F
    search=*&$filter=Rooms/any(room: room/BaseRate ge 60 and room/BaseRate lt 300) and Address/City eq 'Honolulu'
    ```
 
-+ Combination of query string and **$filter**, where the filter creates the subset, and the query string provides the term inputs for full text search over the filtered subset. Using a filter with a query string is the most common usage pattern.
++ Combination of query string and **$filter**, where the filter creates the subset, and the query string provides the term inputs for full text search over the filtered subset. The addition of terms (walking distance theaters) introduces search scores in the results, where documents that best match the terms are ranked higher. Using a filter with a query string is the most common usage pattern.
 
    ```
   search=walking distance theaters&$filter=Rooms/any(room: room/BaseRate ge 60 and room/BaseRate lt 300) and Address/City eq 'Seattle'&$count=true
diff --git a/articles/search/search-get-started-dotnet.md b/articles/search/search-get-started-dotnet.md
@@ -1,7 +1,7 @@
 ---
 title: 'Quickstart: Create a search index in C# using .NET'
 titleSuffix: Azure Cognitive Search
-description: Explains how to create an index, load data, and run queries using C# and the Azure Cognitive Search .NET SDK.
+description: In this C# quickstart, learn how to create an index, load data, and run queries using the Azure Cognitive Search .NET SDK.
 
 manager: nitinme
 author: HeidiSteen
@@ -544,7 +544,7 @@ The [`DocumentsSearchResult`](https://docs.microsoft.com/dotnet/api/microsoft.az
 
     Output includes the same messages as before, with addition of query information and results.
 
-## Clean up
+## Clean up resources
 
 When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
 
diff --git a/articles/search/search-get-started-java.md b/articles/search/search-get-started-java.md
@@ -1,11 +1,11 @@
 ---
 title: 'Quickstart: Create a search index in Java using REST APIs'
 titleSuffix: Azure Cognitive Search
-description: Explains how to create an index, load data, and run queries using Java and the Azure Cognitive Search REST APIs.
+description: In this Java quickstart, learn how to create an index, load data, and run queries using the Azure Cognitive Search REST APIs.
 
 manager: nitinme
-author: lisaleib
-ms.author: v-lilei
+author: HeidiSteen
+ms.author: heidist
 ms.devlang: java
 ms.service: cognitive-search
 ms.topic: quickstart
@@ -812,7 +812,7 @@ Now that you've loaded the hotels documents, you can create search queries to ac
 
     Look for a summary of each query and its results. The run should complete with BUILD SUCCESS message and a zero (0) exit code.
 
-## Clean up
+## Clean up resources
 
 When you're working in your own subscription, at the end of a project, it's a good idea to remove the resources that you no longer need. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
 
@@ -822,10 +822,7 @@ If you are using a free service, remember that you are limited to three indexes,
 
 ## Next steps
 
-In this Java quickstart, you worked through a series of tasks to create an index, load it with documents, and run queries. If you are comfortable with the basic concepts, we recommend the following articles for deeper learning.
+In this Java quickstart, you worked through a series of tasks to create an index, load it with documents, and run queries. If you are comfortable with the basic concepts, we recommend the following article that lists indexer operations in REST.
 
-+ [Index operations](/rest/api/searchservice/index-operations)
-
-+ [Document operations](/rest/api/searchservice/document-operations)
-
-+ [Indexer operations](/rest/api/searchservice/indexer-operations)
+> [!div class="nextstepaction"]
+> [Indexer operations](/rest/api/searchservice/indexer-operations)
diff --git a/articles/search/search-get-started-nodejs.md b/articles/search/search-get-started-nodejs.md
@@ -1,7 +1,7 @@
 ---
 title: 'Quickstart: Create a search index in Node.js using REST APIs'
 titleSuffix: Azure Cognitive Search
-description: Node.js sample for Azure Cognitive Search, demonstrating how to create, load data into, and query from JavaScript.
+description: In this Node.js quickstart, learn how to create an index, load data, and run queries on Azure Cognitive Search using JavaScript and the REST APIs.
 
 author: HeidiSteen
 manager: nitinme
@@ -679,11 +679,12 @@ The **AzureSearchClient** class encapsulates the configuration, URLs, and basic
 
 The overall behavior of the `run` function is to delete the Azure Cognitive Search index if it exists, create the index, add some data, and perform some queries.  
 
-## Clean up 
+## Clean up resources
 
 When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
 
 You can find and manage resources in the portal, using the **All resources** or **Resource groups** link in the left-navigation pane.
+
 If you are using a free service, remember that you are limited to three indexes, indexers, and data sources. You can delete individual items in the portal to stay under the limit. 
 
 ## Next steps
diff --git a/articles/search/search-get-started-portal.md b/articles/search/search-get-started-portal.md
@@ -1,7 +1,7 @@
 ---
 title: Create a search index in the Azure portal
 titleSuffix: Azure Cognitive Search
-description: Use the Import Data wizard to create, load, and query your first search index in Azure Cognitive Search. 
+description: In this portal quickstart, learn how to use the Import Data wizard to create, load, and query your first search index in Azure Cognitive Search. 
 
 author: HeidiSteen
 manager: nitinme
@@ -22,14 +22,7 @@ ms.date: 11/04/2019
 > * [Postman](search-get-started-postman.md)
 > * [Python](search-get-started-python.md)
 
-Use the portal to quickly ramp up on concepts, and write interesting queries against an index within minutes.
-
-> [!div class="checklist"]
-> * Start with a free public sample data set hosted on Azure
-> * Run the **Import data** wizard in Azure Cognitive Search to load data and generate an index
-> * Monitor indexing progress in the portal
-> * View an existing index and options for modifying it
-> * Explore full text search, filters, facets, fuzzy search, and geosearch with **Search explorer**
+Use the portal's **Import data** wizard and **Search explorer** tools to quickly ramp up on concepts, and write interesting queries against an index within minutes.
 
 If the tools are too limiting, you can consider a [code-based introduction to programming Azure Cognitive Search in .NET](search-howto-dotnet-sdk.md) or use [Postman for making REST API calls](search-get-started-postman.md). 
 
@@ -263,7 +256,7 @@ Using the **Search explorer** in the Azure portal, you learned some basic query
 
 You also learned how to find indexes, indexers, and data sources in the portal. Given any new data source in the future, you can use the portal to quickly check its definitions or field collections with minimal effort.
 
-## Clean up
+## Clean up resources
 
 When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
 
@@ -273,8 +266,7 @@ If you are using a free service, remember that you are limited to three indexes,
 
 ## Next steps
 
-You can explore more of Azure Cognitive Search using the programmatic tools:
+While the portal is useful for initial exploration and small tasks, reviewing the APIs early on will help you understand the concepts and workflow on a deeper level:
 
-* [Create an index using .NET SDK](https://docs.microsoft.com/azure/search/search-create-index-dotnet)
-* [Create an index using REST APIs](https://docs.microsoft.com/azure/search/search-create-index-rest-api)
-* [Create an index using Postman or Fiddler and the Azure Cognitive Search REST APIs](search-get-started-postman.md)
+> [!div class="nextstepaction"]
+> [Create an index using .NET SDK](https://docs.microsoft.com/azure/search/search-create-index-dotnet)
diff --git a/articles/search/search-get-started-postman.md b/articles/search/search-get-started-postman.md
@@ -1,7 +1,7 @@
 ---
 title: 'Quickstart: Create a search index in Postman using REST APIs'
 titleSuffix: Azure Cognitive Search
-description: Learn how to call the Azure Cognitive Search REST APIs using Postman and sample data and definitions.
+description: In this REST API quickstart, learn how to call the Azure Cognitive Search REST APIs using Postman and sample data and definitions.
 
 author: HeidiSteen
 manager: nitinme
@@ -284,7 +284,7 @@ Adding `/stats` to your URL returns index information. In Postman, your request
 
 Notice that the api-version syntax differs. For this request, use `?` to append the api-version. The `?` separates the URL path from the query string, while & separates each 'name=value' pair in the query string. For this query, api-version is the first and only item in the query string.
 
-## Clean up
+## Clean up resources
 
 When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
 
diff --git a/articles/search/search-get-started-powershell.md b/articles/search/search-get-started-powershell.md
@@ -1,7 +1,7 @@
 ---
 title: 'Quickstart: Create a search index in PowerShell using REST APIs'
 titleSuffix: Azure Cognitive Search
-description: Explains how to create an index, load data, and run queries using PowerShell's Invoke-RestMethod and the Azure Cognitive Search REST API.
+description: In this REST API quickstart, learn how to create an index, load data, and run queries using PowerShell's Invoke-RestMethod and the Azure Cognitive Search REST API.
 
 manager: nitinme
 author: heidisteen
@@ -386,7 +386,7 @@ $url = 'https://<YOUR-SEARCH-SERVICE>.search.windows.net/indexes/hotels-quicksta
 
 $url = 'https://<YOUR-SEARCH-SERVICE>.search.windows.net/indexes/hotels-quickstart/docs?api-version=2019-05-06&search=pool&$orderby=Address/City asc&$select=HotelName, Address/City, Tags, Rating'
 ```
-## Clean up 
+## Clean up resources
 
 When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
 
diff --git a/articles/search/search-indexer-tutorial.md b/articles/search/search-indexer-tutorial.md
@@ -1,7 +1,7 @@
 ---
-title: 'C# Tutorial: Index data from Azure SQL databases'
+title: 'Tutorial: Index data in C# from Azure SQL databases'
 titleSuffix: Azure Cognitive Search
-description: C# code example showing how to connect to Azure SQL database, extract searchable data, and load it into an Azure Cognitive Search index.
+description: In this C# tutorial, connect to Azure SQL database, extract searchable data, and load it into an Azure Cognitive Search index.
 
 manager: nitinme
 author: HeidiSteen
@@ -12,7 +12,7 @@ ms.date: 11/04/2019
 #Customer intent: As a developer, I want an introduction the indexing Azure SQL data for Azure Cognitive Search.
 ---
 
-# C# Tutorial: Import Azure SQL database using Azure Cognitive Search indexers
+# Tutorial: Import Azure SQL database in C# using Azure Cognitive Search indexers
 
 Learn how to configure an indexer for extracting searchable data from a sample Azure SQL database. [Indexers](search-indexer-overview.md) are a component of Azure Cognitive Search that crawl external data sources, populating a [search index](search-what-is-an-index.md) with content. Of all indexers, the indexer for Azure SQL Database is the most widely used. 
 
