Merge pull request #223570 from chcomley/users/chcomley/swa-28740-application-settings

Refresh SWA application-settings.md

Author: jborsecnik

articles/static-web-apps/apis-overview.md

@@ -42,7 +42,7 @@ The following constraints apply to all API backends:
 
 - Each static web app environment can only be configured with one type of backend API at a time.
 - The API route prefix must be `/api`.
-- Route rules for APIs only support [redirects](configuration.md#defining-routes) and [securing routes with roles](configuration.md#securing-routes-with-roles).
+- Route rules for APIs only support [redirects](configuration.md#define-routes) and [securing routes with roles](configuration.md#securing-routes-with-roles).
 - Only HTTP requests are supported for APIs. WebSocket, for example, is not supported.
 - The maximum duration of each API request 45 seconds.
 - Network isolated backends are not supported.

articles/static-web-apps/application-settings.md

@@ -1,26 +1,20 @@
 ---
 title: Configure application settings for Azure Static Web Apps
-description: Learn to configure application settings for Azure Static Web Apps
+description: Learn how to configure application settings for Azure Static Web Apps.
 services: static-web-apps
 author: burkeholland
 ms.service: static-web-apps
 ms.topic: how-to
-ms.date: 12/21/2021
+ms.date: 01/10/2023
 ms.author: buhollan
-ms.custom: devx-track-js
+ms.custom: devx-track-js, engagement-fy23
 ---
 
 # Configure application settings for Azure Static Web Apps
 
-Application settings hold configuration values that may change, such as database connection strings. Adding application settings allows you to modify the configuration input to your app, without having to change application code.
+When you configure application settings and environment variables, you modify the configuration input to your app without the need to change application code, such as with database connection strings. You can also store secrets used in [authentication configuration](key-vault-secrets.md).
 
-Application settings:
-
-- Are available as environment variables to the backend API of a static web app
-- Can be used to store secrets used in [authentication configuration](key-vault-secrets.md)
-- Are encrypted at rest
-- Are copied to [staging](review-publish-pull-requests.md) and production environments
-- May only be alphanumeric characters, `.`, and `_`
+Application settings are encrypted at rest, copied to [staging](review-publish-pull-requests.md) and production environments, used by backend APIs, and may only be alphanumeric characters, plus `.`  and `_`.
 
 > [!IMPORTANT]
 > The application settings described in this article only apply to the backend API of an Azure Static Web App.
@@ -30,11 +24,11 @@ Application settings:
 ## Prerequisites
 
 - An Azure Static Web Apps application
-- [Azure CLI](/cli/azure/install-azure-cli) — required if you are using the command line
+- [Azure CLI](/cli/azure/install-azure-cli)-required if you are using the command line
 
 ## Configure API application settings for local development
 
-APIs in Azure Static Web Apps are powered by Azure Functions, which allows you to define application settings in the _local.settings.json_ file when you're running the application locally. This file defines application settings in the `Values` property of the configuration.
+APIs in Azure Static Web Apps are powered by Azure Functions, which allows you to define application settings in the _local.settings.json_ file when you run the application locally. This file defines application settings in the `Values` property of the configuration.
 
 > [!NOTE]
 > The _local.settings.json_ file is only used for local development. Use the [Azure portal](#configure-application-settings) to configure application settings for production.
@@ -58,41 +52,33 @@ Settings defined in the `Values` property can be referenced from code as environ
 const connectionString = process.env.DATABASE_CONNECTION_STRING;
 ```
 
-The `local.settings.json` file is not tracked by the GitHub repository because sensitive information, like database connection strings, are often included in the file. Since the local settings remain on your machine, you need to manually configure your settings in Azure.
+The `local.settings.json` file isn't tracked by the GitHub repository because sensitive information, like database connection strings, are often included in the file. Since the local settings remain on your machine, you need to manually configure your settings in Azure.
 
-Generally, configuring your settings is done infrequently, and isn't required with every build.
+Generally, your settings are infrequently set, so aren't required with every build.
 
-## <a name="configure-application-settings"></a>Configure API application settings in Azure
+## Configure application settings
 
-You can configure application settings via the Azure portal or with the Azure CLI.
+You can configure application settings via the [Azure portal](https://portal.azure.com) or with the [Azure CLI](#use-the-azure-cli).
 
 ### Use the Azure portal
 
 The Azure portal provides an interface for creating, updating and deleting application settings.
 
 1. Go to the [Azure portal](https://portal.azure.com).
-
 1. Open your static web app.
-
 1. Select **Configuration** in the sidebar.
-
-1. Select the environment that you want to apply the application settings to. Staging environments are automatically created when a pull request is generated, and are promoted into production once the pull request is merged. You can set application settings per environment.
-
+1. Select the environment to which you want to apply the application settings. You can configure application settings per environment. When you create a pull request, staging environments are automatically created, and then promoted into production when you merge the pull request. 
 1. Select **+ Add** to add a new app setting.
-
-    :::image type="content" source="media/application-settings/configuration.png" alt-text="Azure Static Web Apps configuration view":::
-
+   :::image type="content" source="media/application-settings/configuration.png" alt-text="Screenshot of Azure Static Web Apps configuration view":::
 1. Enter a **Name** and **Value**.
-
 1. Select **OK**.
-
 1. Select **Save**.
 
 ### Use the Azure CLI
 
-You can use the `az staticwebapp appsettings` command to update your settings in Azure.
+Use the `az staticwebapp appsettings` command to update your settings in Azure.
 
-- In a terminal or command line, execute the following command to add or update a setting named `message` with a value of `Hello world`. Make sure to replace the placeholder `<YOUR_APP_ID>` with your value.
+In a terminal or command line, execute the following command to add or update a setting named `message` with a value of `Hello world`. Make sure to replace the placeholder `<YOUR_APP_ID>` with your value.
 
    ```azurecli
    az staticwebapp appsettings set --name <YOUR_APP_ID> --setting-names "message=Hello world"
@@ -101,30 +87,32 @@ You can use the `az staticwebapp appsettings` command to update your settings in
   > [!TIP]
   > You can add or update multiple settings by passing multiple name-value pairs to `--setting-names`.
 
-### View application settings with the Azure CLI
-
-Application settings are available to view through the Azure CLI.
+#### View application settings with the Azure CLI
 
-- In a terminal or command line, execute the following command. Make sure to replace the placeholder `<YOUR_APP_ID>` with your value.
+In a terminal or command line, execute the following command. Make sure to replace the placeholder `<YOUR_APP_ID>` with your value.
 
    ```azurecli
    az staticwebapp appsettings list --name <YOUR_APP_ID>
    ```
 
-### Delete application settings with the Azure CLI
+#### Delete application settings with the Azure CLI
 
-Application settings can be deleted through the Azure CLI.
-
-- In a terminal or command line, execute the following command to delete a setting named `message`. Make sure to replace the placeholder `<YOUR_APP_ID>` with your value.
+In a terminal or command line, execute the following command to delete a setting named `message`. Make sure to replace the placeholder `<YOUR_APP_ID>` with your value.
 
    ```azurecli
    az staticwebapp appsettings delete --name <YOUR_APP_ID> --setting-names "message"
    ```
 
   > [!TIP]
-  > You can delete multiple settings by passing multiple setting names to `--setting-names`.
+  > Delete multiple settings by passing multiple setting names to `--setting-names`.
 
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Configure front-end frameworks](front-end-frameworks.md)
+> [Define configuration for Azure Static Web Apps in the _staticwebapp.config.json_ file](configuration.md)
+
+## Related articles
+
+- [Override defaults with custom registration](authentication-custom.md)
+- [Define settings that control the build process](./build-configuration.md)
+- [API overview](apis-overview.md)

articles/static-web-apps/build-configuration.md

@@ -228,7 +228,7 @@ If you want to skip building the API, you can bypass the automatic build and dep
 
 Steps to skip building the API:
 
-- In the *staticwebapp.config.json* file, set `apiRuntime` to the correct runtime and version. Refer to [Configure Azure Static Web Apps](configuration.md#selecting-the-api-language-runtime-version) for the list of supported runtimes and versions.
+- In the *staticwebapp.config.json* file, set `apiRuntime` to the correct runtime and version. Refer to [Configure Azure Static Web Apps](configuration.md#select-the-api-language-runtime-version) for the list of supported runtimes and versions.
     ```json
     {
       "platform": {