checkpoint

Author: HeidiSteen

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

@@ -70,7 +70,9 @@ We recommend [Visual Studio](https://visualstudio.microsoft.com/vs/community/) f
 
 In this section, you update a search index and send a query that invokes semantic ranking. Visual Studio Code displays the response after you run each cell. For more information about each step, see [Explaining the code](#explaining-the-code).
 
+<!-- ```csharp
 
+``` -->
 
 ### Run the program
 
@@ -85,11 +87,11 @@ Add `SemanticConfiguration` to a search index definition. If you're updating an
 + [Update an index with a semantic configuration](#add-a-semantic-configuration-to-the-index)
 + [Query the index using semantic parameters](#add-semantic-ranking-to-queries)
 
-### Add a semantic configuration to the index
+### Update an index with a semantic configuration
 
 TBD
 
-### Add semantic ranking to queries
+### Query the index using semantic parameters
 
 Here's a query that invokes semantic ranker, with search options for specifying parameters:
 

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

@@ -9,7 +9,7 @@ ms.date: 06/27/2025
 
 [!INCLUDE [Semantic ranker introduction](semantic-ranker-intro.md)]
 
-> [!TIP] 
+> [!TIP]
 > You can [download the source code](https://github.com/Azure-Samples/azure-search-rest-samples/tree/main/Quickstart-semantic-search) to start with a finished project or follow these steps to create your own. 
 
 ## Set up the client
@@ -20,15 +20,15 @@ We recommend [Visual Studio Code](https://code.visualstudio.com/download) with a
 
 1. Start Visual Studio Code and create a new .http or .rest file.
 
-1. At the top, specify environment variables for your search service, authorization, and index name.
+1. At the top, set environment variables for your search service, authorization, and index name.
 
    + For @baseURL, sign in to the Azure portal and copy the URL from the search service **Overview** page.
 
-   + For @token, follow the instruction in [Connect without keys](../../search-get-started-rbac.md) to get your personal identity token.
+   + For @token, follow the instructions in [Connect without keys](../../search-get-started-rbac.md) to get your personal identity token.
 
    + For @index-name, provide a unique name or use the default, *hotel-semantic-quickstart*.
 
-1. Paste in your first request and then select **Send**. This request returns a list of existing indexes. You should get an HTTP 200 Success status code and a list of indexes, including hotels-sample-index. This step confirms access to the search service.
+1. To test the connection, send your first request. This GET request returns a list of existing indexes. You should get an HTTP 200 Success status code and a list of indexes, including hotels-sample-index used in this quickstart.
 
    ```http
    ### List existing indexes by name (verify the connection)
@@ -39,7 +39,11 @@ We recommend [Visual Studio Code](https://code.visualstudio.com/download) with a
 
 ## Update and query the index
 
-In this section, you make REST API calls to update a search index and send a query that invokes semantic ranking. Visual Studio Code displays the response to each request in an adjacent pane. For more information about each step, see [Explaining the code](#explaining-the-code).
+In this section, you make REST API calls to update a search index to include a semantic configuration, and then send a query that invokes semantic ranking. Visual Studio Code displays the response to each request in an adjacent pane. For more information about each step, see [Explaining the code](#explaining-the-code).
+
+```json
+TBD
+```
 
 ## Explaining the code
 
@@ -48,10 +52,10 @@ This section explains the REST API calls that you made to:
 + [Update an index with a semantic configuration](#add-a-semantic-configuration-to-the-index)
 + [Query the index using semantic parameters](#add-semantic-ranking-to-queries)
 
-### Add a semantic configuration to the index
+### Update an index with a semantic configuration
 
 TBD
 
-### Add semantic ranking to queries
+### Query the index using semantic parameters
 
 TBD