@@ -15,7 +15,7 @@ ms.custom:
 
 # Example: Create a custom skill using the Bing Entity Search API
 
-In this example, learn how to create a web API custom skill. This skill will accept locations, public figures, and organizations, and return descriptions for them. The example uses an [Azure Function](https://azure.microsoft.com/services/functions/) to wrap the [Bing Entity Search API](https://azure.microsoft.com/services/cognitive-services/bing-entity-search-api/) so that it implements the custom skill interface.
+In this example, learn how to create a web API custom skill. This skill will accept locations, public figures, and organizations, and return descriptions for them. The example uses an [Azure Function](https://azure.microsoft.com/services/functions/) to wrap the [Bing Entity Search API](/previous-versions/bing/search-apis/bing-entity-search/overview) so that it implements the custom skill interface.
 
 ## Prerequisites
 

@@ -147,7 +147,7 @@ Each field also has a series of index attributes that specify whether Azure AI S
 
 ### Create a documents payload and upload documents
 
-Use an [index action](/python/api/azure-search-documents/azure.search.documents.models.indexaction) for the operation type, such as upload or merge-and-upload. Documents originate from the [HotelsData](https://github.com/Azure-Samples/azure-search-sample-data/blob/main/hotels/HotelsData_toAzureSearch.JSON) sample on GitHub.
+Use an [index action](/python/api/azure-search-documents/azure.search.documents.models.indexaction) for the operation type, such as upload or merge-and-upload. Documents originate from the [HotelsData](https://github.com/Azure-Samples/azure-search-sample-data/blob/main/hotels/HotelsData_toAzureSearch.json) sample on GitHub.
 
 ### Search an index
 

@@ -19,6 +19,7 @@ In Azure AI Search, a [vector store](../../vector-store.md) has an index schema
 - 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) or [find an existing service](https://portal.azure.com/#view/Microsoft_Azure_ProjectOxford/CognitiveServicesHub/~/CognitiveSearch) in your current subscription.
+    - The `Search Index Data Contributor` role assigned at the scope of the service.
     - You can use a free search service for most of this quickstart, but we recommend the Basic tier or higher for larger data files.
     - To run the query example that invokes [semantic reranking](../../semantic-search-overview.md), your search service must be at the Basic tier or higher with [semantic ranker enabled](../../semantic-how-to-enable-disable.md).
 
@@ -111,14 +112,14 @@ In this section, you create a vector index in Azure AI Search with [SearchIndexC
 
 1. Run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/createIndex.js
     ```
 1. The output of this code shows that the index is created successfully:
 
-    ```console
-    Using Azure Search endpoint: https://my-service.search.windows.net
-    Using index name: hotels-vector-quickstart
+    ```output
+    Using Azure Search endpoint: https://<search-service-name>.search.windows.net
+    Using Azure Search index: <vector-index-name>
     Creating index...
     hotels-vector-quickstart created
     ```
@@ -142,7 +143,7 @@ Creating and loading the index are separate steps. You created the index schema
 
 In Azure AI Search, the index stores all searchable content, while the search engine executes queries against that index.
 
-1. Create a `uploadDocuments.js` file in the `src` directory.
+1. Create an `uploadDocuments.js` file in the `src` directory.
 1. Copy the following code into the file.
 
     :::code language="javascript" source="~/azure-search-javascript-samples/quickstart-vector-js/src/uploadDocuments.js" :::
@@ -153,12 +154,14 @@ In Azure AI Search, the index stores all searchable content, while the search en
 
 1. Build and run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/uploadDocuments.js
     ```
 1. The output of this code shows that the documents are indexed and ready for search:
 
-    ```console
+    ```output
+    Using Azure Search endpoint: https://<search-service-name>.search.windows.net
+    Using Azure Search index: <vector-index-name>
     Uploading documents...
     Key: 1, Succeeded: true, ErrorMessage: none
     Key: 2, Succeeded: true, ErrorMessage: none
@@ -171,7 +174,7 @@ In Azure AI Search, the index stores all searchable content, while the search en
     All documents indexed successfully.
     ```
 
-    Key takeaways about the upload_documents() method and this example:
+    Key takeaways about the uploadDocuments() method and this example:
     
     * Your code interacts with a specific search index hosted in your Azure AI Search service through the SearchClient, which is the main object provided by the @azure/search-documents package. The SearchClient provides access to index operations such as:
         * Data ingestion - uploadDocuments(), mergeDocuments(), deleteDocuments(), etc.
@@ -211,15 +214,15 @@ The first example demonstrates a basic scenario where you want to find document
 
 1. Build and run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/searchSingle.js
     ```
 
 1. The output of this code shows the relevant docs for the query `quintessential lodging near running trails, eateries, retail`. 
 
-    ```console
-    Using Azure Search endpoint: https://ai-search-dib-2.search.windows.net
-    Using index name: hotels-vector-quickstart-0627-4
+    ```output
+    Using Azure Search endpoint: https://<search-service-name>.search.windows.net
+    Using Azure Search index: <vector-index-name>
     
     
     Single Vector search found 5
@@ -247,14 +250,14 @@ You can add filters, but the filters are applied to the nonvector content in you
 
 1. Build and run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/searchSingleWithFilter.js
     ```
 1. The output of this code shows the relevant documents for the query with the filter for `free wifi` applied:
 
-    ```console
-    Using Azure Search endpoint: https://ai-search-dib-2.search.windows.net
-    Using index name: hotels-vector-quickstart-0627-4
+    ```output
+    Using Azure Search endpoint: https://<search-service-name>.search.windows.net
+    Using Azure Search index: <vector-index-name>
     
     
     Single Vector search found 2
@@ -273,15 +276,15 @@ You can specify a geospatial filter to limit results to a specific geographic ar
     :::code language="javascript" source="~/azure-search-javascript-samples/quickstart-vector-js/src/searchSingleWithFilterGeo.js" :::
 1. Build and run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/searchSingleWithFilterGeo.js
     ```
 
 1. The output of this code shows the relevant documents for the query with the geospatial post-processing exclusion filter applied:
 
-    ```console
-    Using Azure Search endpoint: https://ai-search-dib-2.search.windows.net
-    Using index name: hotels-vector-quickstart-0627-4
+    ```output
+    Using Azure Search endpoint: https://<search-service-name>.search.windows.net
+    Using Azure Search index: <vector-index-name>
     
     
     Single Vector search found 2
@@ -305,14 +308,14 @@ This search uses [SearchClient](/javascript/api/@azure/search-documents/searchcl
     :::code language="javascript" source="~/azure-search-javascript-samples/quickstart-vector-js/src/searchHybrid.js" :::
 1. Build and run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/searchHybrid.js
     ```
 1. The output of this code shows the relevant documents for the hybrid search:
 
-    ```console
-    Using Azure Search endpoint: https://ai-search-dib-2.search.windows.net
-    Using index name: hotels-vector-quickstart-0627-4
+    ```output
+    Using Azure Search endpoint: https://<search-service-name>.search.windows.net
+    Using Azure Search index: <vector-index-name>
     
     
     Hybrid search found 7 then limited to top 5
@@ -417,7 +420,7 @@ This search uses [SearchClient](/javascript/api/@azure/search-documents/searchcl
            "@search.score": 0.8133763,
            "HotelId": "3",
            "HotelName": "Gastronomic Landscape Hotel",
-           "Description": "The Hotel stands out for its gastronomic excellence under the management of William Dough, who advises on and oversees all of the Hotel’s restaurant services.",
+           "Description": "The Hotel stands out for its gastronomic excellence under the management of William Dough, who advises on and oversees all of the Hotel's restaurant services.",
            "Category": "Resort and Spa"
        }
    ]
@@ -436,15 +439,15 @@ This search uses [SearchClient](/javascript/api/@azure/search-documents/searchcl
 
 1. Build and run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/searchSemanticHybrid.js
     ```
 
 1. The output of this code shows the relevant documents for the semantic hybrid search:
 
-    ```console
-    Using Azure Search endpoint: https://ai-search-dib-2.search.windows.net
-    Using index name: hotels-vector-quickstart-0627-4
+    ```output
+    Using Azure Search endpoint: https://<search-service-name>.search.windows.net
+    Using Azure Search index: <vector-index-name>
 
     
     Semantic hybrid search found 7 then limited to top 5
@@ -480,7 +483,7 @@ This search uses [SearchClient](/javascript/api/@azure/search-documents/searchcl
       Re-ranker Score: 2.0582215785980225
       HotelId: 3
       HotelName: Gastronomic Landscape Hotel
-      Description: The Gastronomic Hotel stands out for its culinary excellence under the management of William Dough, who advises on and oversees all of the Hotel’s restaurant services.
+      Description: The Gastronomic Hotel stands out for its culinary excellence under the management of William Dough, who advises on and oversees all of the Hotel's restaurant services.
       Category: Suite
     ```
 
@@ -509,7 +512,7 @@ If you want to keep the search service, but delete the index and documents, you
 
 1. Build and run the file:
 
-    ```console
+    ```bash
     node -r dotenv/config src/deleteIndex.js
     ```
 

@@ -89,7 +89,7 @@ If you signed in to the [Azure portal](https://portal.azure.com), you're signed
 
 ## Create a common configuration class
 
-Create a file in `src/main/java/com/azure/search/quickstart` called `SearchConfig.java` to read the properties file and hold the environment variables and authentication credential.
+Create a file in `src/main/java/com/azure/search/quickstart` called `SearchConfig.java` to read the properties file and hold the configuration values and authentication credential.
 
 ```java
 package com.azure.search.quickstart;
@@ -476,7 +476,7 @@ Optionally, you can add captions to extract portions of the text and apply hit h
 
 1. Output should include a new caption element alongside search field. Captions are the most relevant passages in a result. If your index includes larger chunks of text, a caption is helpful for extracting the most interesting sentences.
 
-    ```console
+    ```output
     Search result #1:
       Re-ranker Score: 2.613231658935547
       HotelName: Uptown Chic Hotel
@@ -604,7 +604,7 @@ To produce a semantic answer, the question and answer must be closely aligned, a
 
     Recall that answers are *verbatim content* pulled from your index and might be missing phrases that a user would expect to see. To get *composed answers* as generated by a chat completion model, considering using a [RAG pattern](../../retrieval-augmented-generation-overview.md) or [agentic retrieval](../../search-agentic-retrieval-concept.md).
 
-    ```console
+    ```output
     Semantic answer result #1:
     Semantic Answer: Nature is Home on the beach. Explore the shore by day, and then come home to our shared living space to relax around a stone fireplace, sip something warm, and explore the<em> library </em>by night. Save up to 30 percent. Valid Now through the end of the year. Restrictions and blackouts may apply.
     Semantic Answer Score: 0.9829999804496765

@@ -70,7 +70,7 @@ The information retrieval system provides the searchable index, query logic, and
 
 The LLM receives the original prompt, plus the results from Azure AI Search. The LLM analyzes the results and formulates a response. If the LLM is ChatGPT, the user interaction might consist of multiple conversation turns. An Azure solution most likely uses Azure OpenAI, but there's no hard dependency on this specific service.
 
-Except for features currently in previewAzure AI Search doesn't provide native LLM integration for prompt flows or chat preservation, so you need to write code that handles orchestration and state. You can review demo source ([Azure-Samples/azure-search-openai-demo](https://github.com/Azure-Samples/azure-search-openai-demo)), updated for agentic retrieval, for a blueprint of what a full solution entails. We also recommend [Azure AI Foundry](/azure/ai-foundry/concepts/retrieval-augmented-generation) to create RAG-based Azure AI Search solutions that integrate with LLMs.
+Except for features currently in preview, Azure AI Search doesn't provide native LLM integration for prompt flows or chat preservation, so you need to write code that handles orchestration and state. You can review demo source ([Azure-Samples/azure-search-openai-demo](https://github.com/Azure-Samples/azure-search-openai-demo)), updated for agentic retrieval, for a blueprint of what a full solution entails. We also recommend [Azure AI Foundry](/azure/ai-foundry/concepts/retrieval-augmented-generation) to create RAG-based Azure AI Search solutions that integrate with LLMs.
 
 ## Searchable content in Azure AI Search
 

@@ -20,6 +20,12 @@ zone_pivot_groups: search-get-started-vector-search
 
 ::: zone-end
 
+::: zone pivot="java"
+
+[!INCLUDE [Java quickstart](includes/quickstarts/search-get-started-vector-java.md)]
+
+::: zone-end
+
 ::: zone pivot="javascript"
 
 [!INCLUDE [JavaScript quickstart](includes/quickstarts/search-get-started-vector-javascript.md)]

@@ -37,7 +37,7 @@ To work through the examples in this article, you need the Azure portal or a [RE
 
 Use these instructions to create a container and database in Cosmos DB for testing purposes.
 
-1. [Download HotelsData_toCosmosDB.JSON](https://github.com/HeidiSteen/azure-search-sample-data/blob/main/hotels/HotelsData_toCosmosDB.JSON) from GitHub to create a container in Cosmos DB that contains a subset of the sample hotels data set.
+1. [Download HotelsData_toCosmosDB.json](https://github.com/Azure-Samples/azure-search-sample-data/blob/main/hotels/HotelsData_toCosmosDB.json) from GitHub to create a container in Cosmos DB that contains a subset of the sample hotels data set.
 
 1. Sign in to the Azure portal and [create an account, database, and container](/azure/cosmos-db/nosql/quickstart-portal) on Cosmos DB. 
 
@@ -55,7 +55,7 @@ Use these instructions to create a container and database in Cosmos DB for testi
 
 1. In **Data Explorer**, expand *hotelsdb* and *hotels*, and then select **Items**.
 
-1. Select **Upload Item** and then select *HotelsData_toCosmosDB.JSON* file that you downloaded from GitHub.
+1. Select **Upload Item** and then select *HotelsData_toCosmosDB.json* file that you downloaded from GitHub.
 
 1. Right-click **Items** and select **New SQL query**. The default query is `SELECT * FROM c`.
 

@@ -38,7 +38,7 @@ Use these instructions to create a table in Azure Storage for testing purposes.
 
 1. [Install Azure Storage Explorer](https://azure.microsoft.com/products/storage/storage-explorer/#Download-4).
 
-1. [Download HotelsData_toAzureSearch.csv](https://github.com/HeidiSteen/azure-search-sample-data/blob/main/hotels/HotelsData_toAzureSearch.csv) from GitHub. This file is a subset of the built-in hotels sample dataset. It omits the rooms collection, translated descriptions, and geography coordinates.
+1. [Download HotelsData_toAzureSearch.csv](https://github.com/Azure-Samples/azure-search-sample-data/blob/main/hotels/HotelsData_toAzureSearch.csv) from GitHub. This file is a subset of the built-in hotels sample dataset. It omits the rooms collection, translated descriptions, and geography coordinates.
 
 1. In Azure Storage Explorer, sign in to Azure, select your subscription, and then select your storage account.
 

@@ -105,7 +105,7 @@ You can create an Azure AI Search service in any of the following Azure public r
 | Japan West​ | ✅ |  | ✅ | ✅ |  |
 | Korea Central | ✅ | ✅ | ✅ | ✅ | ✅ |
 | Korea South​​ |  |  | ✅ | ✅ |  |
-| Malaysia West |  | ✅ |  |  |  |  |
+| Malaysia West |  | ✅ |  |  |  |  
 | New Zealand North |  | ✅ |  |  |  |
 | South India |  | ✅ |  |  |  |
 | Southeast Asia​​ | ✅ | ✅ | ✅ | ✅ | ✅ |

@@ -119,7 +119,7 @@ The private endpoint uses an IP address from the virtual network address space f
 
 :::image type="content" source="media/search-security-overview/inbound-private-link-azure-cog-search.png" alt-text="sample architecture diagram for private endpoint access":::
 
-While this solution is the most secure, using more services is an added cost so be sure you have a clear understanding of the benefits before diving in. For more information about costs, see the [pricing page](https://azure.microsoft.com/pricing/details/private-link/). For more information about how these components work together, [watch this video](https://learn.microsoft.com/Shows/AI-Show/Azure-Cognitive-Search-Whats-new-in-security). Coverage of the private endpoint option starts at 5:48 into the video. For instructions on how to set up the endpoint, see [Create a Private Endpoint for Azure AI Search](service-create-private-endpoint.md).
+While this solution is the most secure, using more services is an added cost so be sure you have a clear understanding of the benefits before diving in. For more information about costs, see the [pricing page](https://azure.microsoft.com/pricing/details/private-link/). For more information about how these components work together, [watch this video](/Shows/AI-Show/Azure-Cognitive-Search-Whats-new-in-security). Coverage of the private endpoint option starts at 5:48 into the video. For instructions on how to set up the endpoint, see [Create a Private Endpoint for Azure AI Search](service-create-private-endpoint.md).
 
 ### Network security perimeter
 
@@ -300,4 +300,4 @@ Apply metadata tags to categorize search services based on data sensitivity and
 + [Azure Security](https://azure.microsoft.com/overview/security)
 + [Microsoft Defender for Cloud](/azure/security-center/)
 
-We also recommend the following [video on security features](https://learn.microsoft.com/Shows/AI-Show/Azure-Cognitive-Search-Whats-new-in-security). It's several years old and doesn't cover newer features, but it covers these features: CMK, IP firewalls, and private link. If you use those features, you might find this video helpful.
+We also recommend the following [video on security features](/Shows/AI-Show/Azure-Cognitive-Search-Whats-new-in-security). It's several years old and doesn't cover newer features, but it covers these features: CMK, IP firewalls, and private link. If you use those features, you might find this video helpful.