edits

KarlErickson · KarlErickson · commit a82e24afa2d5 · 2022-11-10T13:35:56.000-08:00
diff --git a/articles/spring-apps/how-to-bind-cosmos.md b/articles/spring-apps/how-to-bind-cosmos.md
@@ -32,53 +32,54 @@ If you don't have a deployed Azure Spring Apps instance, follow the steps in the
 
 1. Add one of the following dependencies to your application's pom.xml pom.xml file. Choose the dependency that is appropriate for your API type.
 
-    * API type: NoSQL
-
-      ```xml
-      <dependency>
-          <groupId>com.azure.spring</groupId>
-          <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId>
-          <version>4.3.0</version>
-      </dependency>
-      ```
-
-    * API type: MongoDB
-
-      ```xml
-      <dependency>
-          <groupId>org.springframework.boot</groupId>
-          <artifactId>spring-boot-starter-data-mongodb</artifactId>
-      </dependency>
-      ```
-
-    * API type: Cassandra
-
-      ```xml
-      <dependency>
-          <groupId>org.springframework.boot</groupId>
-          <artifactId>spring-boot-starter-data-cassandra</artifactId>
-      </dependency>
-      ```
-
-    * API type: Azure Table
-
-      ```xml
-      <dependency>
-          <groupId>com.azure.spring</groupId>
-          <artifactId>spring-cloud-azure-starter-storage-blob</artifactId>
-          <version>4.3.0</version>
-      </dependency>
-      ```
+   * API type: NoSQL
+
+     ```xml
+     <dependency>
+         <groupId>com.azure.spring</groupId>
+         <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId>
+         <version>4.3.0</version>
+     </dependency>
+     ```
+
+   * API type: MongoDB
+
+     ```xml
+     <dependency>
+         <groupId>org.springframework.boot</groupId>
+         <artifactId>spring-boot-starter-data-mongodb</artifactId>
+     </dependency>
+     ```
+
+   * API type: Cassandra
+
+     ```xml
+     <dependency>
+         <groupId>org.springframework.boot</groupId>
+         <artifactId>spring-boot-starter-data-cassandra</artifactId>
+     </dependency>
+     ```
+
+   * API type: Azure Table
+
+     ```xml
+     <dependency>
+         <groupId>com.azure.spring</groupId>
+         <artifactId>spring-cloud-azure-starter-storage-blob</artifactId>
+         <version>4.3.0</version>
+     </dependency>
+     ```
 
 1. Update the current app by running `az spring app deploy`, or create a new deployment for this change by running `az spring app deployment create`.
 
 ## Bind your app to the Azure Cosmos DB
 
-#### [Service Connector](#tab/Service-Connector)
+### [Service Connector](#tab/Service-Connector)
 
 1. Use the Azure CLI to configure your Spring app to connect to a Cosmos SQL Database with a system-assigned managed identity by using the `az spring connection create` command, as shown in the following example.
-    > [!NOTE]
-    > Updating Azure Cosmos DB database settings can take a few minutes to complete.
+
+   > [!NOTE]
+   > Updating Azure Cosmos DB database settings can take a few minutes to complete.
 
    ```azurecli
    az spring connection create cosmos-sql \
@@ -92,34 +93,34 @@ If you don't have a deployed Azure Spring Apps instance, follow the steps in the
        --system-assigned-identity
    ```
 
-    > [!NOTE]
-    > If you're using [Service Connector](../service-connector/overview.md) for the first time, start by running the command `az provider register -n Microsoft.ServiceLinker` to register the Service Connector resource provider.
+   > [!NOTE]
+   > If you're using [Service Connector](../service-connector/overview.md) for the first time, start by running the command `az provider register --namespace Microsoft.ServiceLinker` to register the Service Connector resource provider.
+   >
+   > If you're using Cosmos Cassandra, use a `--key_space` instead of `--database`.
 
-    > [!NOTE]
-    > If you're using Cosmos Cassandra, use a `--key_space` instead of `--database`.
+   > [!TIP]
+   > Run the command `az spring connection list-support-types --output table` to get a list of supported target services and authentication methods for Azure Spring Apps. If the `az spring` command isn't recognized by the system, check that you have installed the required extension by running `az extension add --name spring`.
 
-    > [!TIP]
-    > Run the command `az spring connection list-support-types --output table` to get a list of supported target services and authentication methods for Azure Spring Apps. If the `az spring` command isn't recognized by the system, check that you have installed the required extension by running `az extension add --name spring`.
+1. Alternately, you can use the Azure portal to configure this connection by completing the following steps. The Azure portal provides the same capabilities as the Azure CLI and provides an interactive experience.
 
-1. Or you can use the Azure portal to configure this connection. The Azure portal provides the same capabilities as the Azure CLI and provides an interactive experience.
+   1. Select your Azure Spring Apps instance in the Azure portal and select **Apps** from the navigation menu. Choose the app you want to connect and select **Service Connector** on the navigation menu.
 
-   * Select your Azure Spring Apps instance in the Azure portal and select **Apps** from the left menu. Choose the app you want to connect and select **Service Connector** on the left.
+   1. Select **Create**.
 
-   * Select the **Create** button.
+   1. On the **Basics** tab, for service type, select Cosmos DB, then choose a subscription. For API type, select Core (SQL), choose a Cosmos DB account, and a database. For client type, select Java, then select **Next: Authentication**. If you haven't created your database yet, see [Quickstart: Create an Azure Cosmos DB account, database, container, and items from the Azure portal](../cosmos-db/nosql/quickstart-portal.md).
 
-   * In the **Basics** tab, for Service type, select Cosmos DB. Choose a subscription, for API type, select Core (SQL), choose a Cosmos DB account, a database and for Client type, select Java. Select **Next: Authentication**. Refer to the quickstart on [creating a cosmos database](../cosmos-db/create-cosmosdb-resources-portal.md) for help if your database isn't created yet.
-   * In the **Authentication** tab, choose Connection string. Service Connector automatically retrieves the access key from your Cosmos DB account. Select **Next: Networking**.
+   1. On the **Authentication** tab, choose **Connection string**. Service Connector automatically retrieves the access key from your Cosmos DB account. Select **Next: Networking**.
 
-   * In the **Networking** tab, select "Configure firewall rules to enable access to target service". Select **Next: Review + Create**.
+   1. On the **Networking** tab, select **Configure firewall rules to enable access to target service**, then select **Next: Review + Create**.
 
-   * In the **Review + Create** tab, wait for the validation to pass and then select **Create**. The creation can take a few minutes to complete.
+   1. On the **Review + Create** tab, wait for the validation to pass and then select **Create**. The creation can take a few minutes to complete.
 
-   * Once the connection between your Spring apps and your Cosmos DB database has been generated, you can see it in the Service Connector page and select the unfold button to view the configured connection variables.
+   1. Once the connection between your Spring apps and your Cosmos DB database has been generated, you can see it in the Service Connector page and select the unfold button to view the configured connection variables.
 
-#### [Service Binding](#tab/Service-Binding)
+### [Service Binding](#tab/Service-Binding)
 
- > [!NOTE]
- > We recommend using Service Connector instead of Service Binding to connect your app to your database. Service Binding is going to be deprecated in favor of Service Connector. See Service Connector tab for instructions.
+> [!NOTE]
+> We recommend using Service Connector instead of Service Binding to connect your app to your database. Service Binding is going to be deprecated in favor of Service Connector. For instructions, see the Service Connector tab.
 
 Azure Cosmos DB has five different API types that support binding. The following procedure shows how to use them:
 
@@ -130,25 +131,26 @@ Azure Cosmos DB has five different API types that support binding. The following
 1. Go to your Azure Spring Apps service page in the Azure portal. Go to **Application Dashboard** and select the application to bind to Azure Cosmos DB. This application is the same one you updated or deployed in the previous step.
 
 1. Select **Service binding**, and select **Create service binding**. To fill out the form, select:
+
    * The **Binding type** value **Azure Cosmos DB**.
    * The API type.
    * Your database name.
    * The Azure Cosmos DB account.
 
-    > [!NOTE]
-    > If you are using Cassandra, use a key space for the database name.
+   > [!NOTE]
+   > If you are using Cassandra, use a key space for the database name.
 
 1. Restart the application by selecting **Restart** on the application page.
 
 1. To ensure the service is bound correctly, select the binding name and verify its details. The `property` field should be similar to this example:
 
-    ```properties
-    spring.cloud.azure.cosmos.endpoint=https://<some account>.documents.azure.com:443
-    spring.cloud.azure.cosmos.key=abc******
-    spring.cloud.azure.cosmos.database=testdb
-    ```
+   ```properties
+   spring.cloud.azure.cosmos.endpoint=https://<some account>.documents.azure.com:443
+   spring.cloud.azure.cosmos.key=abc******
+   spring.cloud.azure.cosmos.database=testdb
+   ```
 
-#### [Terraform](#tab/Terraform)
+### [Terraform](#tab/Terraform)
 
 The following Terraform script shows how to set up an Azure Spring Apps app with an Azure Cosmos DB account.
 
diff --git a/articles/spring-apps/how-to-bind-mysql.md b/articles/spring-apps/how-to-bind-mysql.md
@@ -47,9 +47,9 @@ With Azure Spring Apps, you can bind select Azure services to your applications
 
 ## Bind your app to the Azure Database for MySQL instance
 
-#### [Service Connector](#tab/Service-Connector)
+### [Service Connector](#tab/Service-Connector)
 
-Configure your Spring app to connect to an Azure Database for MySQL Flexible Server with a system-assigned managed identity, using the `az spring connection create` command, as shown in the following example.
+To configure your Spring app to connect to an Azure Database for MySQL Flexible Server with a system-assigned managed identity, use the `az spring connection create` command, as shown in the following example.
 
 ```azurecli
 az spring connection create mysql-flexible \
@@ -63,10 +63,10 @@ az spring connection create mysql-flexible \
     --system-assigned-identity
 ```
 
-#### [Service Binding](#tab/Service-Binding)
+### [Service Binding](#tab/Service-Binding)
 
- > [!NOTE]
- > We recommend using Service Connector instead of Service Binding to connect your app to your database. Service Binding is going to be deprecated in favor of Service Connector. See Service Connector tab for instructions.
+> [!NOTE]
+> We recommend using Service Connector instead of Service Binding to connect your app to your database. Service Binding is going to be deprecated in favor of Service Connector. For instructions, see the Service Connector tab.
 
 1. Note the admin username and password of your Azure Database for MySQL account.
 
@@ -89,7 +89,7 @@ az spring connection create mysql-flexible \
    spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
    ```
 
-#### [Terraform](#tab/Terraform)
+### [Terraform](#tab/Terraform)
 
 The following Terraform script shows how to set up an Azure Spring Apps app with Azure Database for MySQL.
 
diff --git a/articles/spring-apps/how-to-bind-redis.md b/articles/spring-apps/how-to-bind-redis.md
@@ -30,22 +30,22 @@ If you don't have a deployed Azure Spring Apps instance, follow the steps in the
 
 ## Prepare your Java project
 
-1. Add the following dependency to your project's pom.xml file:
+1. Add the following dependency to your project's *pom.xml* file:
 
-    ```xml
-    <dependency>
-        <groupId>org.springframework.boot</groupId>
-        <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
-    </dependency>
-    ```
+   ```xml
+   <dependency>
+       <groupId>org.springframework.boot</groupId>
+       <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
+   </dependency>
+   ```
 
-1. Remove any `spring.redis.*` properties from the `application.properties` file
+1. Remove any `spring.redis.*` properties from the *application.properties* file
 
 1. Update the current deployment using `az spring app update` or create a new deployment using `az spring app deployment create`.
 
 ## Bind your app to the Azure Cache for Redis
 
-#### [Service Connector](#tab/Service-Connector)
+### [Service Connector](#tab/Service-Connector)
 
 1. Use the Azure CLI to configure your Spring app to connect to a Redis database with an access key using the `az spring connection create` command, as shown in the following example.
 
@@ -61,35 +61,34 @@ If you don't have a deployed Azure Spring Apps instance, follow the steps in the
        --secret
    ```
 
-    > [!NOTE]
-    > If you're using [Service Connector](../service-connector/overview.md) for the first time, start by running the command `az provider register -n Microsoft.ServiceLinker` to register the Service Connector resource provider.
-
-    > [!NOTE]
-    > If you're using Redis Enterprise, use the `az spring connection create redis-enterprise` command instead.
+   > [!NOTE]
+   > If you're using [Service Connector](../service-connector/overview.md) for the first time, start by running the command `az provider register --namespace Microsoft.ServiceLinker` to register the Service Connector resource provider.
+   >
+   > If you're using Redis Enterprise, use the `az spring connection create redis-enterprise` command instead.
 
-    > [!TIP]
-    > Run the command `az spring connection list-support-types --output table` to get a list of supported target services and authentication methods for Azure Spring Apps. If the `az spring` command isn't recognized by the system, check that you have installed the required extension by running `az extension add --name spring`.
+   > [!TIP]
+   > Run the command `az spring connection list-support-types --output table` to get a list of supported target services and authentication methods for Azure Spring Apps. If the `az spring` command isn't recognized by the system, check that you have installed the required extension by running `az extension add --name spring`.
 
-1. Or you can use the Azure portal to configure this connection. The Azure portal provides the same capabilities as the Azure CLI and provides an interactive experience.
+1. Alternately, you can use the Azure portal to configure this connection by completing the following steps. The Azure portal provides the same capabilities as the Azure CLI and provides an interactive experience.
 
-   * Select your Azure Spring Apps instance in the Azure portal and select **Apps** from the left menu. Choose the app you want to connect and select **Service Connector** on the left.
+   1. Select your Azure Spring Apps instance in the Azure portal and then select **Apps** from the navigation menu. Choose the app you want to connect and then select **Service Connector** on the navigation menu.
 
-   * Select the **Create** button.
+   1. Select **Create**.
 
-   * In the **Basics** tab, for Service type, select Cache for Redis. Choose a subscription and a Redis cache server. Fill in the Redis database name ("0" in this example) and under Client type, select Java. Select **Next: Authentication**.
+   1. On the **Basics** tab, for service type, select Cache for Redis. Choose a subscription and a Redis cache server. Fill in the Redis database name ("0" in this example) and under client type, select Java. Select **Next: Authentication**.
 
-   * In the **Authentication** tab, choose Connection string. Service Connector will automatically retrieve the access key from your Redis database account. Networking
+   1. On the **Authentication** tab, choose **Connection string**. Service Connector will automatically retrieve the access key from your Redis database account. Select **Next: Networking**.
 
-   * In the **Networking** tab, select "Configure firewall rules to enable access to target service". **Click Review + Create.**
+   1. On the **Networking** tab, select **Configure firewall rules to enable access to target service**, then select **Review + Create**.
 
-   * In the **Review + Create** tab, wait for the validation to pass and then select **Create**. The creation can take a few minutes to complete.
+   1. On the **Review + Create** tab, wait for the validation to pass and then select **Create**. The creation can take a few minutes to complete.
 
-   * Once the connection between your Spring app your Redis database has been generated, you can see it in the Service Connector page and select the unfold button to view the configured connection variables.
+   1. Once the connection between your Spring app your Redis database has been generated, you can see it in the Service Connector page and select the unfold button to view the configured connection variables.
 
-#### [Service Binding](#tab/Service-Binding)
+### [Service Binding](#tab/Service-Binding)
 
- > [!NOTE]
- > We recommend using Service Connector instead of Service Binding to connect your app to your database. Service Binding is going to be deprecated in favor of Service Connector. See Service Connector tab for instructions.
+> [!NOTE]
+> We recommend using Service Connector instead of Service Binding to connect your app to your database. Service Binding is going to be deprecated in favor of Service Connector. For instructions, see the Service Connector tab.
 
 1. Go to your Azure Spring Apps service page in the Azure portal. Go to **Application Dashboard** and select the application to bind to Azure Cache for Redis. This application is the same one you updated or deployed in the previous step.
 
@@ -99,14 +98,14 @@ If you don't have a deployed Azure Spring Apps instance, follow the steps in the
 
 1. To ensure the service binding is correct, select the binding name and verify its details. The `property` field should look like this:
 
-    ```properties
-    spring.redis.host=some-redis.redis.cache.windows.net
-    spring.redis.port=6380
-    spring.redis.password=abc******
-    spring.redis.ssl=true
-    ```
+   ```properties
+   spring.redis.host=some-redis.redis.cache.windows.net
+   spring.redis.port=6380
+   spring.redis.password=abc******
+   spring.redis.ssl=true
+   ```
 
-#### [Terraform](#tab/Terraform)
+### [Terraform](#tab/Terraform)
 
 The following Terraform script shows how to set up an Azure Spring Apps app with Azure Cache for Redis.
 
