Merge pull request #5670 from haileytap/full-text-qs

 [Azure Search] Move REST and PowerShell to search-get-started-text.md

Author: rmca14

articles/search/.openpublishing.redirection.search.json

@@ -415,6 +415,16 @@
             "source_path_from_root": "/articles/search/tutorial-multimodal-index-image-verbalization-skill.md",
             "redirect_url": "/azure/search/tutorial-document-layout-image-verbalization",
             "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/search/search-get-started-rest.md",
+            "redirect_url": "/azure/search/search-get-started-text",
+            "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/search/search-get-started-powershell.md",
+            "redirect_url": "/azure/search/search-get-started-text",
+            "redirect_document_id": false
         }
     ]
   }

articles/search/cognitive-search-tutorial-blob.md

@@ -87,7 +87,7 @@ For this tutorial, connections to Azure AI Search require an endpoint and an API
 
 ## Set up your REST file
 
-1. Start Visual Studio Code and open the [skillset-tutorial.rest](https://github.com/Azure-Samples/azure-search-rest-samples/tree/main/skillset-tutorial) file. See [Quickstart: Text search using REST](search-get-started-rest.md) if you need help with the REST client.
+1. Start Visual Studio Code and open the [skillset-tutorial.rest](https://github.com/Azure-Samples/azure-search-rest-samples/tree/main/skillset-tutorial) file. See [Quickstart: Full-text search](search-get-started-text.md) if you need help with the REST client.
 
 1. Provide values for the variables: search service endpoint, search service admin API key, an index name, a connection string to your Azure Storage account, and the blob container name.
 

articles/search/includes/quickstarts/agentic-retrieval-setup.md

@@ -4,12 +4,12 @@ author: haileytap
 ms.author: haileytapia
 ms.service: azure-ai-search
 ms.topic: include
-ms.date: 6/15/2025
+ms.date: 06/23/2025
 ---
 
 ## Configure role-based access
 
-You can use search service API keys or Microsoft Entra ID with role assignments. Keys are easier to start with, but roles are more secure. This quickstart assumes roles.
+You can use search service API keys or Microsoft Entra ID with role assignments. Keys are easier to start with, but roles are more secure.
 
 To configure the recommended role-based access:
 
@@ -25,17 +25,17 @@ To configure the recommended role-based access:
 
     + **Search Index Data Reader**
 
-For agentic retrieval, Azure AI Search also needs access to your Azure OpenAI Foundry resource. 
+For agentic retrieval, Azure AI Search also needs access to your Azure OpenAI Foundry resource.
 
 1. [Create a system-assigned managed identity](../../search-howto-managed-identities-data-sources.md#create-a-system-managed-identity) on your Azure AI Search service. Here's how to do it using the Azure CLI:
 
    ```azurecli
    az search service update --name YOUR-SEARCH-SERVICE-NAME --resource-group YOUR-RESOURCE-GROUP-NAME --identity-type SystemAssigned
    ```
-   
+
     If you already have a managed identity, you can skip this step.
 
-1. On your Azure AI Foundry resource, assign **Cognitive Services User** to the managed identity that you created for your search service. 
+1. On your Azure AI Foundry resource, assign **Cognitive Services User** to the managed identity that you created for your search service.
 
 ## Deploy models
 
@@ -63,7 +63,7 @@ To deploy the Azure OpenAI models:
 
 ## Get endpoints
 
-In your code, you specify the following endpoints to establish connections with your Azure AI Search service and Azure AI Foundry resource. These steps assume that you [configured role-based access as described previously](#configure-role-based-access). 
+In your code, you specify the following endpoints to establish connections with your Azure AI Search service and Azure AI Foundry resource. These steps assume that you [configured role-based access as described previously](#configure-role-based-access).
 
 To obtain your service endpoints:
 
@@ -73,11 +73,11 @@ To obtain your service endpoints:
 
     1. From the left pane, select **Overview**.
 
-    1. Copy the URL, which should be similar to `https://my-service.search.windows.net`. 
+    1. Copy the URL, which should be similar to `https://my-service.search.windows.net`.
 
 1. On your Azure AI Foundry resource:
 
-    1. From the left pane, select **Resource Management** > **Keys and Endpoint**. 
+    1. From the left pane, select **Resource Management** > **Keys and Endpoint**.
 
     1. Select the **OpenAI** tab and copy the URL that looks similar to `https://my-resource.openai.azure.com`.
 

articles/search/includes/quickstarts/full-text-csharp.md

@@ -4,25 +4,27 @@ author: haileytap
 ms.author: haileytapia
 ms.service: azure-ai-search
 ms.topic: include
-ms.date: 06/13/2025
+ms.date: 06/23/2025
 ---
 
 [!INCLUDE [Full text introduction](full-text-intro.md)]
 
 > [!TIP]
-> You can [download the source code](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/main/quickstart/v11) to start with a finished project or follow these steps to create your own.
+> You can download the [source code](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/main/quickstart) to start with a finished project or follow these steps to create your own.
 
 ## 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. [Create a service](../../search-create-service-portal.md) if you don't have one. For this quickstart, you can use a free service.
 
 ## Microsoft Entra ID prerequisites
 
-For the recommended keyless authentication with Microsoft Entra ID, you need to:
+For the recommended keyless authentication with Microsoft Entra ID, you must:
+
+- Install the [Azure CLI](/cli/azure/install-azure-cli).
 
-- Install the [Azure CLI](/cli/azure/install-azure-cli) used for keyless authentication with Microsoft Entra ID.
-- Assign both of the `Search Service Contributor` and `Search Index Data Contributor` roles to your user account. You can assign roles in the Azure portal under **Access control (IAM)** > **Add role assignment**. For more information, see [Connect to Azure AI Search using roles](../../search-security-rbac.md).
+- Assign the `Search Service Contributor` and `Search Index Data Contributor` roles to your user account. You can assign roles in the Azure portal under **Access control (IAM)** > **Add role assignment**. For more information, see [Connect to Azure AI Search using roles](../../search-security-rbac.md).
 
 ## Retrieve resource information
 

articles/search/includes/quickstarts/full-text-intro.md

@@ -4,9 +4,9 @@ author: haileytap
 ms.author: haileytapia
 ms.service: azure-ai-search
 ms.topic: include
-ms.date: 03/04/2025
+ms.date: 06/26/2025
 ---
 
-In this quickstart, you use the Azure.Search.Documents client library to create, load, and query a search index using sample data for [full text search](../../search-lucene-query-architecture.md). Full text search uses Apache Lucene for indexing and queries, and a BM25 ranking algorithm for scoring results.
+In this quickstart, you use the Azure.Search.Documents client library to create, load, and query a search index with sample data for [full-text search](../../search-lucene-query-architecture.md). Full-text search uses Apache Lucene for indexing and queries and the BM25 ranking algorithm for scoring results.
 
-This quickstart creates and queries a small hotels-quickstart index containing data about four hotels.
+This quickstart uses fictional hotel data from the [azure-search-sample-data](https://github.com/Azure-Samples/azure-search-sample-data/tree/main/hotels/hotel-json-documents) repo to populate the index.

articles/search/includes/quickstarts/full-text-java.md

@@ -4,24 +4,27 @@ author: haileytap
 ms.author: haileytapia
 ms.service: azure-ai-search
 ms.topic: include
-ms.date: 06/13/2025
+ms.date: 06/23/2025
 ---
 
 [!INCLUDE [Full text introduction](full-text-intro.md)]
 
 > [!TIP]
-> You can [download the source code](https://github.com/Azure-Samples/azure-search-java-samples/tree/main/quickstart) to start with a finished project or follow these steps to create your own.
+> You can download the [source code](https://github.com/Azure-Samples/azure-search-java-samples/tree/main/quickstart) to start with a finished project or follow these steps to create your own.
 
 ## 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. [Create a service](../../search-create-service-portal.md) if you don't have one. For this quickstart, you can use a free service.
 
 ## Microsoft Entra ID prerequisites
 
-For the recommended keyless authentication with Microsoft Entra ID, you need to:
-- Install the [Azure CLI](/cli/azure/install-azure-cli) used for keyless authentication with Microsoft Entra ID.
-- Assign both of the `Search Service Contributor` and `Search Index Data Contributor` roles to your user account. You can assign roles in the Azure portal under **Access control (IAM)** > **Add role assignment**. For more information, see [Connect to Azure AI Search using roles](../../search-security-rbac.md).
+For the recommended keyless authentication with Microsoft Entra ID, you must:
+
+- Install the [Azure CLI](/cli/azure/install-azure-cli).
+
+- Assign the `Search Service Contributor` and `Search Index Data Contributor` roles to your user account. You can assign roles in the Azure portal under **Access control (IAM)** > **Add role assignment**. For more information, see [Connect to Azure AI Search using roles](../../search-security-rbac.md).
 
 ## Retrieve resource information
 

articles/search/includes/quickstarts/full-text-javascript.md

@@ -4,24 +4,27 @@ author: haileytap
 ms.author: haileytapia
 ms.service: azure-ai-search
 ms.topic: include
-ms.date: 06/13/2025
+ms.date: 06/23/2025
 ---
 
 [!INCLUDE [Full text introduction](full-text-intro.md)]
 
 > [!TIP]
-> You can [download the source code](https://github.com/Azure-Samples/azure-search-javascript-samples/tree/main/quickstart) to start with a finished project or follow these steps to create your own.
+> You can download the [source code](https://github.com/Azure-Samples/azure-search-javascript-samples/tree/main/quickstart) to start with a finished project or follow these steps to create your own.
 
 ## 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. [Create a service](../../search-create-service-portal.md) if you don't have one. For this quickstart, you can use a free service.
 
 ## Microsoft Entra ID prerequisites
 
-For the recommended keyless authentication with Microsoft Entra ID, you need to:
-- Install the [Azure CLI](/cli/azure/install-azure-cli) used for keyless authentication with Microsoft Entra ID.
-- Assign both of the `Search Service Contributor` and `Search Index Data Contributor` roles to your user account. You can assign roles in the Azure portal under **Access control (IAM)** > **Add role assignment**. For more information, see [Connect to Azure AI Search using roles](../../search-security-rbac.md).
+For the recommended keyless authentication with Microsoft Entra ID, you must:
+
+- Install the [Azure CLI](/cli/azure/install-azure-cli).
+
+- Assign the `Search Service Contributor` and `Search Index Data Contributor` roles to your user account. You can assign roles in the Azure portal under **Access control (IAM)** > **Add role assignment**. For more information, see [Connect to Azure AI Search using roles](../../search-security-rbac.md).
 
 ## Retrieve resource information
 
@@ -531,7 +534,7 @@ AzureKeyCredential credential = new AzureKeyCredential("<Your search service adm
 
 ### Create index
 
-The *hotels_quickstart_index.json* file defines how Azure AI Search works with the documents you load in the next step. Each field is identified by a `name` and have a specified `type`. Each field also has a series of index attributes that specify whether Azure AI Search can search, filter, sort, and facet upon the field. Most of the fields are simple data types, but some, like `AddressType` are complex types that allow you to create rich data structures in your index. You can read more about [supported data types](/rest/api/searchservice/supported-data-types) and index attributes described in [Create Index (REST)](/rest/api/searchservice/indexes/create). 
+The *hotels_quickstart_index.json* file defines how Azure AI Search works with the documents you load in the next step. Each field is identified by a `name` and has a specified `type`. Each field also has a series of index attributes that specify whether Azure AI Search can search, filter, sort, and facet upon the field. Most of the fields are simple data types, but some, like `AddressType` are complex types that allow you to create rich data structures in your index. You can read more about [supported data types](/rest/api/searchservice/supported-data-types) and index attributes described in [Create Index (REST)](/rest/api/searchservice/indexes/create). 
 
 With our index definition in place, we want to import *hotels_quickstart_index.json* at the top of *index.js* so the main function can access the index definition.