Moved intro into an include

Author: HeidiSteen

articles/search/includes/quickstarts/dotnet-semantic.md

@@ -8,6 +8,10 @@ ms.topic: include
 ms.date: 06/13/2025
 ---
 
+[!INCLUDE [Semantic ranker introduction](semantic-ranker-intro.md)]
+
+### CSHARP INCLUDE STARTS HERE
+
 Build a console application by using the [**Azure.Search.Documents**](/dotnet/api/overview/azure/search.documents-readme) client library to add semantic ranking to an existing search index.
 
 Alternatively, you can [download the source code](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/main/quickstart-semantic-search/SemanticSearchQuickstart) to start with a finished project.

articles/search/includes/quickstarts/python-semantic.md

@@ -8,6 +8,10 @@ ms.topic: include
 ms.date: 06/13/2025
 ---
 
+[!INCLUDE [Semantic ranker introduction](semantic-ranker-intro.md)]
+
+### PYTHON INCLUDE STARTS HERE
+
 Use a Jupyter notebook and the [**azure-search-documents**](/python/api/overview/azure/search-documents-readme) library in the Azure SDK for Python to learn about semantic ranking.
 
 Alternatively, you can [download and run a finished notebook](https://github.com/Azure-Samples/azure-search-python-samples/tree/main/Quickstart-Semantic-Search).

articles/search/includes/quickstarts/semantic-ranker-intro.md

@@ -0,0 +1,30 @@
+---
+manager: nitinme
+author: haileytap
+ms.author: haileytapia
+ms.service: azure-ai-search
+ms.topic: include
+ms.date: 06/25/2025
+---
+
+In this quickstart, you learn about the index and query modifications that invoke semantic ranker.
+
+In Azure AI Search, [semantic ranking](semantic-search-overview.md) is query-side functionality that uses machine reading comprehension from Microsoft to rescore search results, promoting the most semantically relevant matches to the top of the list. Depending on the content and the query, semantic ranking can [significantly improve search relevance](https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-cognitive-search-outperforming-vector-search-with-hybrid/ba-p/3929167) with minimal developer effort. Semantic ranking is also required for [agentic retrieval (preview)](search-agentic-retrieval-concept.md).
+
+You can add a semantic configuration to an existing index with no rebuild requirement. Semantic ranking is effective on content that's informational or descriptive.
+
+## Prerequisites
+
++ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+
++ An [Azure AI Search service](search-create-service-portal.md), at Basic tier or higher, with [semantic ranker enabled](semantic-how-to-enable-disable.md).
+
++ A [new or existing index](search-how-to-create-search-index.md) with descriptive or verbose text fields, attributed as retrievable in your index. 
+
+## How to add a semantic ranker
+
+To use semantic ranker, add a *semantic configuration* to a search index, and add parameters to a query. If you have an existing index, you can make these changes without having to reindex your content because there's no impact on the structure of your searchable content.
+
++ A semantic configuration sets a priority order for fields that contribute a title, keywords, and content used in semantic reranking. Field prioritization allows for faster processing.
+
++ Queries that invoke semantic ranker include parameters for query type and whether captions and answers are returned. You can add these parameters to your existing query logic. There's no conflict with other parameters.

articles/search/includes/quickstarts/semantic-ranker-rest.md

@@ -7,6 +7,9 @@ ms.topic: include
 ms.date: 06/25/2025
 ---
 
+[!INCLUDE [Semantic ranker introduction](semantic-ranker-intro.md)]
+
+### REST INCLUDE STARTS HERE
 
 In this quickstart, you use the [Azure AI Search REST APIs](/rest/api/searchservice) to configure and use a semantic ranker.
 

articles/search/search-get-started-semantic.md

@@ -17,26 +17,6 @@ zone_pivot_groups: search-get-started-semantic
 
 # Quickstart: Semantic ranking using .NET or Python
 
-In this quickstart, you learn about the index and query modifications that invoke semantic ranker.
-
-In Azure AI Search, [semantic ranking](semantic-search-overview.md) is query-side functionality that uses machine reading comprehension from Microsoft to rescore search results, promoting the most semantically relevant matches to the top of the list. Depending on the content and the query, semantic ranking can [significantly improve search relevance](https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-cognitive-search-outperforming-vector-search-with-hybrid/ba-p/3929167) with minimal developer effort. Semantic ranking is also required for [agentic retrieval (preview)](search-agentic-retrieval-concept.md).
-
-## Prerequisites
-
-+ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-
-+ An [Azure AI Search service](search-create-service-portal.md), at Basic tier or higher, with [semantic ranker enabled](semantic-how-to-enable-disable.md).
-
-+ A new or existing index with descriptive or verbose text fields, attributed as retrievable in your index. You can add a semantic configuration to an existing index with no rebuild requirement. Semantic ranking is effective on content that's informational or descriptive.
-
-## How to add a semantic ranker
-
-To use semantic ranker, add a *semantic configuration* to a search index, and add parameters to a query. If you have an existing index, you can make these changes without having to reindex your content because there's no impact on the structure of your searchable content.
-
-+ A semantic configuration sets a priority order for fields that contribute a title, keywords, and content used in semantic reranking. Field prioritization allows for faster processing.
-
-+ Queries that invoke semantic ranker include parameters for query type and whether captions and answers are returned. You can add these parameters to your existing query logic. There's no conflict with other parameters.
-
 ::: zone pivot="csharp"
 
 [!INCLUDE [C# quickstart](includes/quickstarts/dotnet-semantic.md)]