Merge pull request #273458 from HeidiSteen/heidist-freshness

[azure search] Partial freshness updates on search traffic analytics (feature has bugs)

Author: v-dirichards

articles/search/includes/tutorial-add-search-website-create-app.md

@@ -1,20 +1,20 @@
 ---
 ms.topic: include
-ms.date: 09/21/2023
+ms.date: 04/25/2024
 author: HeidiSteen
 ms.author: heidist
 ms.service: cognitive-search
 ms.custom:
   - ignite-2023
 ---
 
-Deploy the search-enabled website as an Azure Static Web Apps site. This deployment includes both the React app and the Function app.  
+Deploy the search-enabled website as an Azure Static Web Apps site. This deployment includes both the React app for the web pages, and the Function app for search operations.  
 
 The static web app pulls the information and files for deployment from GitHub using your fork of the samples repository.  
 
 ## Create a Static Web App in Visual Studio Code
 
-1. In Visual Studio Code, open a folder at the repository root (for example, `azure-search-javascript-samples`).
+1. In Visual Studio Code, make sure you're at the repository root, and not the bulk-insert folder (for example, `azure-search-javascript-samples`).
 
 1. Select **Azure** from the Activity Bar, then open **Resources** from the side bar. 
 
@@ -40,7 +40,7 @@ The static web app pulls the information and files for deployment from GitHub us
     |Select a location for new resources. | For Node.js: Select `West US 2` during the Azure Function programming model (PM) v4 preview. For C# and Python, select a region near you. |
     |Choose build preset to configure default project structure. |Select **Custom**. |
     |Select the location of your client application code | `search-website-functions-v4/client`<br><br>This is the path, from the root of the repository, to your static web app. |
-    |Select the location of your Azure Functions code | `search-website-functions-v4/api`<br><br>This is the path, from the root of the repository, to your static web app. If there are no other functions in the repository, you won't be prompted for the function code location. Currently, you'll need to perform extra steps to ensure the function code location is correct. These steps are performed after the resource is created and are documented in this article. |
+    |Select the location of your Azure Functions code | `search-website-functions-v4/api`<br><br>This is the path, from the root of the repository, to your static web app. If there are no other functions in the repository, you won't be prompted for the function code location. *Currently, you'll need to perform extra steps to ensure the function code location is correct. These steps are performed after the resource is created and are documented in this article.* |
     |Enter the path of your build output... | `build`<br><br>This is the path, from your static web app, to your generated files.|
 
     If you get an error about an incorrect region, make sure the resource group and static web app resource are in one of the supported regions listed in the error response. 
@@ -55,7 +55,7 @@ The static web app pulls the information and files for deployment from GitHub us
 
      :::image type="content" source="../media/tutorial-javascript-static-web-app/visual-studio-code-azure-activity-log.png" alt-text="Screenshot of the Activity Log in Visual Studio Code." border="true":::
 
-1. Currently, the YML file is created with erroneous path syntax for the Azure function code. Use this workaround to correct the syntax. You can perform this step as soon as the YML file is created. A new workflow will launch as soon as you push the updates:
+1. *Currently, the YML file is created with erroneous path syntax for the Azure function code*. Use this workaround to correct the syntax and rerun the workflow. You can perform this step as soon as the YML file is created. A new workflow launches as soon as you push the updates:
 
    1. In Visual Studio Code explorer, open the `./.github/workflows/` directory.
 
@@ -113,7 +113,7 @@ The static web app pulls the information and files for deployment from GitHub us
 
 1. Keep this query key to use in the next section. The query key authorizes read access to a search index. 
 
-## Add configuration settings in Azure portal
+## Add environment variables in Azure portal
 
 The Azure Function app won't return search data until the search secrets are in settings. 
 
@@ -122,9 +122,9 @@ The Azure Function app won't return search data until the search secrets are in
 
     :::image type="content" source="../media/tutorial-javascript-static-web-app/open-static-web-app-in-azure-portal.png" alt-text="Screenshot of Visual Studio Code showing Azure Static Web Apps explorer with the Open in Portal option shown.":::
 
-1. Select **Configuration** then select **+ Add**.
+1. Select **Environment variables** then select **+ Add application setting**.
 
-    :::image type="content" source="../media/tutorial-javascript-static-web-app/add-new-application-setting-to-static-web-app-in-portal.png" alt-text="Screenshot of Visual Studio Code showing the Azure Static Web Apps explorer with the Configuration option shown.":::
+    :::image type="content" source="../media/tutorial-javascript-static-web-app/add-new-application-setting-to-static-web-app-in-portal.png" alt-text="Screenshot of the static web app's environment variables page in the Azure portal.":::
 
 1. Add each of the following settings:
 
@@ -137,7 +137,7 @@ The Azure Function app won't return search data until the search secrets are in
 
     Azure AI Search requires different syntax for filtering collections than it does for strings. Add a `*` after a field name to denote that the field is of type `Collection(Edm.String)`. This allows the Azure Function to add filters correctly to queries.
 
-1. Select **Save** to save the settings. 
+1. Check your settings to make sure they look like the following screenshot.
 
     :::image type="content" source="../media/tutorial-javascript-static-web-app/save-new-application-setting-to-static-web-app-in-portal.png" alt-text="Screenshot of browser showing Azure portal with the button to save the settings for your app.":::
 
@@ -147,6 +147,8 @@ The Azure Function app won't return search data until the search secrets are in
 
     :::image type="content" source="../media/tutorial-javascript-static-web-app/visual-studio-code-extension-fresh-resource-2.png" alt-text="Screenshot of Visual Studio Code showing the Azure Static Web Apps explorer with the new application settings." border="true":::
 
+If you don't see the application settings, revisit the steps for updating and relaunching the GitHub workflow.
+
 ## Use search in your static web app
 
 1. In Visual Studio Code, open the [Activity bar](https://code.visualstudio.com/docs/getstarted/userinterface), and select the Azure icon.

articles/search/includes/tutorial-add-search-website-what-sample-does.md

@@ -1,6 +1,6 @@
 ---
 ms.topic: include
-ms.date: 07/18/2023
+ms.date: 04/25/2024
 author: HeidiSteen
 ms.author: heidist
 ms.service: cognitive-search