edits

Author: jmart1428

articles/app-service/environment/creation.md

@@ -1,6 +1,6 @@
 ---
 title: Create an App Service Environment
-description: Learn how to create an App Service Environment. This single-tenant deployment of Azure App Service integrates with an Azure virtual network and supports internal or external virtual IP types.
+description: Learn how to create an App Service Environment, which integrates with an Azure virtual network and supports internal or external virtual IP types.
 author: seligj95
 ms.topic: article
 ms.date: 05/07/2025
@@ -13,7 +13,7 @@ ms.custom:
 
 An [App Service Environment][Intro] is a single-tenant deployment of Azure App Service that integrates with an Azure virtual network. Each App Service Environment deployment requires a dedicated subnet that other resources can't use.
 
-## Before you create your App Service Environment
+## Before you create an App Service Environment
 
 - Review the following settings before you create your environment. You can't change them later.
 
@@ -27,52 +27,59 @@ An [App Service Environment][Intro] is a single-tenant deployment of Azure App S
 
    Ensure that your subnet is large enough to accommodate the maximum scale of your App Service Environment. Use a `/24` subnet with 256 addresses as the recommended size.
 
-- Select your virtual IP type. The virtual IP type determines how your apps are accessed.
+- Select your virtual IP (VIP) type. The virtual IP type determines how your apps are accessed.
 
    Choose between the following two virtual IP types:
 
-    - *Internal VIP:* Your apps use an address within your App Service Environment subnet that doesn't appear in public Domain Name System (DNS). When you create your App Service Environment in the Azure portal, you can set up an Azure private DNS zone. Specify an *Inbound IP address* and select either *Automatic* or *Manual*.
+    - *Internal VIP:* Your apps use an address within your App Service Environment subnet that doesn't appear in public Domain Name System (DNS). When you create an App Service Environment in the Azure portal, you can set up an Azure private DNS zone. Specify an **Inbound IP address** and select either **Automatic** or **Manual**.
 
-    - *External VIP:* Your apps use a public-facing address listed in public DNS. You can specify an *Inbound IP address* and select either *Automatic* or *Manual*. If you select *Manual*, you must create a standard *Public IP address* in Azure first.
+    - *External VIP:* Your apps use a public-facing address listed in public DNS. You can specify an **Inbound IP address** and select either **Automatic** or **Manual**. If you select **Manual**, you must create a standard public IP address in Azure first.
 
 - Select your deployment type. The deployment type determines how your apps are distributed across the App Service Environment. Choose between the following three types:
 
-   - *Regional deployment:* Also called a *nonzonal* deployment, this option is available in all regions that support App Service Environment v3. In regions with availability zones, your apps run in a single zone. If any availability zone in the region experiences an outage, regional deployments could experience downtime.
+   - *Regional deployment:* Also called a *nonzonal* deployment, this option is available in all regions that support App Service Environment v3. In regions with availability zones, your apps run in a single zone. If any availability zone in the region experiences an outage, regional deployments can experience downtime.
 
      You must pay a minimum charge for one instance of Windows Isolated v2 in your App Service plan. When you use one or more instances, the charge is removed. This fee isn't additive.
 
-   - *Zone redundant deployment:* Zone redundancy ensures that workloads remain available even if one zone experiences an outage. In regions that support availability zones, you can configure App Service Environments so that apps are distributed across multiple availability zones within the same region. Your must include at least two instances in your App Service plan to ensure redundancy across zones. You can scale out by adding one or more instances at a time. For more information, see [Reliability in App Service Environments](../../reliability/reliability-app-service-environment.md).
+   - *Zone redundant deployment:* Zone redundancy ensures that workloads remain available even if one zone experiences an outage. In regions that support availability zones, you can configure App Service Environments so that apps are distributed across multiple availability zones within the same region. You must include at least two instances in your App Service plan to ensure redundancy across zones. You can scale out by adding one or more instances at a time. For more information, see [Reliability in App Service Environments](../../reliability/reliability-app-service-environment.md).
 
-   - *Host group deployment:* Your apps are deployed onto a dedicated host group. The dedicated host group isn't zone redundant. You can install and use your App Service Environment on dedicated hardware. There's no minimum instance charge for using App Service Environment on a dedicated host group. However, you must pay for the host group when you provision the App Service Environment. You also pay a discounted App Service plan rate as you create your plans and scale out.
+   - *Host group deployment:* Your apps are deployed onto a dedicated host group. The dedicated host group isn't zone redundant. You can install and use your App Service Environment on dedicated hardware. There's no minimum instance charge for using an App Service Environment on a dedicated host group. However, you must pay for the host group when you provision the App Service Environment. You also pay a discounted App Service plan rate when you create your plans and scale out.
 
      A dedicated host group deployment allocates a finite number of cores, which both the App Service plans and the infrastructure roles use. This type of deployment can't reach the 200 total instance count normally available in App Service Environment. The number of total possible instances is related to the total number of App Service plan instances, plus the load-based number of infrastructure roles.
 
 ## Create an App Service Environment in the portal
 
-To create an App Service Environment in the Azure portal, do the following steps.
+To create an App Service Environment in the Azure portal, do the following steps:
 
 1. Search Azure Marketplace for *App Service Environment v3*.
 
 1. In the **Basics** tab, do the following steps:
+
    -  Select the subscription.
    - Select or create the resource group.
    - Enter the name of your App Service Environment.
 
    Choose the **Virtual IP** type:
+
    - Select **Internal** if you want the inbound address to be within your subnet.
    - Select **External** if you want the inbound address to face the public internet.
 
-   Enter an **App Service Environment Name** that's less than 36 characters. The name also serves as the domain suffix. For example, if the name is *contoso* and you have an internal VIP, the domain suffix is `contoso.appserviceenvironment.net`. If the name is *contoso* and you have an external VIP, the domain suffix is `contoso.p.azurewebsites.net`. 
+   Enter an **App Service Environment Name** that's fewer than 36 characters. The name also serves as the domain suffix.
+
+     - For example, if the name is *contoso* and you have an internal VIP, the domain suffix is `contoso.appserviceenvironment.net`.
+     - If the name is *contoso* and you have an external VIP, the domain suffix is `contoso.p.azurewebsites.net`. 
 
    :::image type="content" source="./media/creation/creation-basics.png" alt-text="Screenshot that shows the App Service Environment basics tab." border="true" lightbox="./media/creation/creation-basics.png":::
 
 1. In the **Hosting** tab, configure the following settings:
 
-   - For **Physical hardware isolation**, select **Enabled** or **Disabled**. If you enable this option, you can deploy on dedicated hardware. When you create an App Service Environment v3 with a dedicated host deployment, Azure bills you for two dedicated hosts. As you scale, extra resources incur charges at the specialized Isolated v2 rate for each vCore.
+   - For **Physical hardware isolation**, select **Enabled** or **Disabled**.
+   
+     If you enable this option, you can deploy on dedicated hardware. When you create an App Service Environment v3 with a dedicated host deployment, Azure bills you for two dedicated hosts. As you scale, extra resources incur charges at the specialized Isolated v2 rate for each vCore. For each instance, the following allocations apply:
 
-     - I1v2 uses two vCores for each instance.
-     - I2v2 uses four vCores for each instance.
-     - I3v2 uses eight vCores for each instance.
+     - I1v2 uses two vCores.
+     - I2v2 uses four vCores.
+     - I3v2 uses eight vCores.
 
    - For **Zone redundancy**, select **Enabled** or **Disabled**.
 
@@ -89,13 +96,13 @@ To create an App Service Environment in the Azure portal, do the following steps
 
      - Specify a private IP address by using the **Manual** option for **Inbound IP address**.
 
-   > [!NOTE]
-   > If you use an existing subnet that has either a network security group or route table associated with it, you must either delegate the subnet to `Microsoft.web/hostingEnvironments` or ensure that you have at least the following RBAC permissions for the associated resources:
+   :::image type="content" source="./media/creation/creation-networking-internal.png" alt-text="Screenshot that shows App Service Environment networking (App Service Environment Internal) selections." border="true" lightbox="./media/creation/creation-networking-internal.png":::
+
+      > [!NOTE]
+   > If you use an existing subnet that has either a network security group or route table associated with it, you must either delegate the subnet to `Microsoft.web/hostingEnvironments` or ensure that you have at least the following role-based access control (RBAC) permissions for the associated resources:
    > * `Microsoft.Network/routeTables/join/action`
    > * `Microsoft.Network/networkSecurityGroups/join/action`
 
-   :::image type="content" source="./media/creation/creation-networking-internal.png" alt-text="Screenshot that shows App Service Environment networking (App Service Environment Internal) selections." border="true" lightbox="./media/creation/creation-networking-internal.png":::
-
    If you create an App Service Environment with an external VIP, you can select a public IP address by using the **Manual** option for **Inbound IP address**.
 
    :::image type="content" source="./media/creation/creation-networking-external.png" alt-text="Screenshot that shows App Service Environment networking (App Service Environment External) selections." border="true":::
@@ -104,7 +111,7 @@ To create an App Service Environment in the Azure portal, do the following steps
 
 After you successfully create your App Service Environment, you can select it as a location when you create your apps.
 
-To learn how to create an App Service Environment from an Azure Resource Manager template (ARM template), see [Create an App Service Environment by using an ARM template](how-to-create-from-template.md).
+For more information, see [Create an App Service Environment by using an ARM template](how-to-create-from-template.md).
 
 <!--Links-->
 [Intro]: ./overview.md

articles/app-service/environment/toc.yml

@@ -9,7 +9,7 @@
 - name: Quickstarts
   expanded: true
   items:
-  - name: Create App Service Environment in portal
+  - name: Create an App Service Environment in the Azure portal
     href: creation.md
   - name: Create an App Service Environment using Terraform
     href: creation-terraform.md
@@ -25,19 +25,19 @@
     href: networking.md
   - name: Reliability
     items:
-    - name: Reliability in Azure App Service Environment
+    - name: Reliability in an Azure App Service Environment
       href: ../../reliability/reliability-app-service-environment.md?toc=%2fazure%2fapp-service%2fenvironment%2ftoc.json&bc=/azure/app-service/breadcrumb/toc.json
-    - name: Configure App Service Environment for zone redundancy
+    - name: Configure an App Service Environment for zone redundancy
       href: configure-zone-redundancy-environment.md
   - name: Certificates
     href: overview-certificates.md
   - name: Diagnostics
     href: ../overview-diagnostics.md?toc=%2fazure%2fapp-service%2fenvironment%2ftoc.json
 - name: How-To guides
   items:
-  - name: Using App Service Environment
+  - name: Use an App Service Environment
     href: using.md
-  - name: Create App Service Environment from template
+  - name: Create an App Service Environment from template
     href: how-to-create-from-template.md
   - name: App Service Environment custom settings
     href: app-service-app-service-environment-custom-settings.md
@@ -47,7 +47,7 @@
     href: how-to-custom-domain-suffix.md
   - name: Upgrade preference for planned maintenance
     href: how-to-upgrade-preference.md
-- name: Migrate to App Service Environment v3
+- name: Migrate to an App Service Environment v3
   items:
   - name: Auto-migration overview
     href: auto-migration.md