Merge pull request #127179 from cephalin/pr#126463

update custom domain docs

Author: ttorble

articles/app-service/app-service-web-tutorial-custom-domain.md

@@ -6,7 +6,7 @@ keywords: app service, azure app service, domain mapping, domain name, existing
 ms.assetid: dc446e0e-0958-48ea-8d99-441d2b947a7c
 ms.devlang: nodejs
 ms.topic: tutorial
-ms.date: 08/13/2020
+ms.date: 08/25/2020
 ms.custom: mvc, seodec18
 ---
 
@@ -134,38 +134,34 @@ After you add the CNAME and TXT records, the DNS records page looks like the fol
 
 #### Enable the CNAME record mapping in Azure
 
-In the left navigation of the app page in the Azure portal, select **Custom domains**.
-
-![Custom domain menu](./media/app-service-web-tutorial-custom-domain/custom-domain-menu.png)
-
-In the **Custom domains** page of the app, add the fully qualified custom DNS name (`www.contoso.com`) to the list.
+1. In the left navigation of the app page in the Azure portal, select **Custom domains**.
 
-Select the **+** icon next to **Add custom domain**.
+    ![Custom domain menu](./media/app-service-web-tutorial-custom-domain/custom-domain-menu.png)
 
-![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
+1. In the **Custom domains** page of the app, add the fully qualified custom DNS name (`www.contoso.com`) to the list.
 
-Type the fully qualified domain name that you added a CNAME record for, such as `www.contoso.com`.
+1. Select **Add custom domain**.
 
-Select **Validate**.
+    ![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
 
-The **Add custom domain** page is shown.
+1. Type the fully qualified domain name that you added a CNAME record for, such as `www.contoso.com`.
 
-Make sure that **Hostname record type** is set to **CNAME (www\.example.com or any subdomain)**.
+1. Select **Validate**. The **Add custom domain** page is shown.
 
-Select **Add custom domain**.
+1. Make sure that **Hostname record type** is set to **CNAME (www\.example.com or any subdomain)**. Select **Add custom domain**.
 
-![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name-cname.png)
+    ![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name-cname.png)
 
-It might take some time for the new custom domain to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
+    It might take some time for the new custom domain to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
 
-![CNAME record added](./media/app-service-web-tutorial-custom-domain/cname-record-added.png)
+    ![CNAME record added](./media/app-service-web-tutorial-custom-domain/cname-record-added.png)
 
-> [!NOTE]
-> A **Not Secure** label for your custom domain means that it's not yet bound to a TLS/SSL certificate, and any HTTPS request from a browser to your custom domain will receive and error or warning, depending on the browser. To add a TLS binding, see [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md).
+    > [!NOTE]
+    > A warning label for your custom domain means that it's not yet bound to a TLS/SSL certificate, and any HTTPS request from a browser to your custom domain will receive and error or warning, depending on the browser. To add a TLS binding, see [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md).
 
-If you missed a step or made a typo somewhere earlier, you see a verification error at the bottom of the page.
+    If you missed a step or made a typo somewhere earlier, you see a verification error at the bottom of the page.
 
-![Verification error](./media/app-service-web-tutorial-custom-domain/verification-error-cname.png)
+    ![Verification error](./media/app-service-web-tutorial-custom-domain/verification-error-cname.png)
 
 <a name="a" aria-hidden="true"></a>
 
@@ -219,33 +215,29 @@ When the records are added, the DNS records page looks like the following exampl
 
 Back in the app's **Custom domains** page in the Azure portal, add the fully qualified custom DNS name (for example, `contoso.com`) to the list.
 
-Select the **+** icon next to **Add custom domain**.
-
-![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
-
-Type the fully qualified domain name that you configured the A record for, such as `contoso.com`.
-
-Select **Validate**.
+1. Select **Add custom domain**.
 
-The **Add custom domain** page is shown.
+    ![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
 
-Make sure that **Hostname record type** is set to **A record (example.com)**.
+1. Type the fully qualified domain name that you configured the A record for, such as `contoso.com`. 
 
-Select **Add custom domain**.
+1. Select **Validate**. The **Add custom domain** page is shown.
 
-![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name.png)
+1. Make sure that **Hostname record type** is set to **A record (example.com)**. Select **Add custom domain**.
 
-It might take some time for the new custom domain to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
+    ![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name.png)
 
-![A record added](./media/app-service-web-tutorial-custom-domain/a-record-added.png)
+    It might take some time for the new custom domain to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
 
-> [!NOTE]
-> A **Not Secure** label for your custom domain means that it's not yet bound to a TLS/SSL certificate, and any HTTPS request from a browser to your custom domain will receive and error or warning, depending on the browser. To add a TLS binding, see [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md).
-
-If you missed a step or made a typo somewhere earlier, you see a verification error at the bottom of the page.
-
-![Verification error](./media/app-service-web-tutorial-custom-domain/verification-error.png)
+    ![A record added](./media/app-service-web-tutorial-custom-domain/a-record-added.png)
 
+    > [!NOTE]
+    > A warning label for your custom domain means that it's not yet bound to a TLS/SSL certificate, and any HTTPS request from a browser to your custom domain will receive and error or warning, depending on the browser. To add a TLS binding, see [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md).
+    
+    If you missed a step or made a typo somewhere earlier, you see a verification error at the bottom of the page.
+    
+    ![Verification error](./media/app-service-web-tutorial-custom-domain/verification-error.png)
+    
 <a name="wildcard" aria-hidden="true"></a>
 
 ### Map a wildcard domain
@@ -275,33 +267,31 @@ When the CNAME is added, the DNS records page looks like the following example:
 
 You can now add any subdomain that matches the wildcard name to the app (for example, `sub1.contoso.com`, `sub2.contoso.com` and `*.contoso.com` both match `*.contoso.com`).
 
-In the left navigation of the app page in the Azure portal, select **Custom domains**.
-
-![Custom domain menu](./media/app-service-web-tutorial-custom-domain/custom-domain-menu.png)
-
-Select the **+** icon next to **Add custom domain**.
+1. In the left navigation of the app page in the Azure portal, select **Custom domains**.
 
-![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
+    ![Custom domain menu](./media/app-service-web-tutorial-custom-domain/custom-domain-menu.png)
 
-Type a fully qualified domain name that matches the wildcard domain (for example, `sub1.contoso.com`), and then select **Validate**.
+1. Select **Add custom domain**.
 
-The **Add custom domain** button is activated.
+    ![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
 
-Make sure that **Hostname record type** is set to **CNAME record (www\.example.com or any subdomain)**.
+1. Type a fully qualified domain name that matches the wildcard domain (for example, `sub1.contoso.com`), and then select **Validate**.
 
-Select **Add custom domain**.
+    The **Add custom domain** button is activated.
 
-![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name-cname-wildcard.png)
+1. Make sure that **Hostname record type** is set to **CNAME record (www\.example.com or any subdomain)**. Select **Add custom domain**.
 
-It might take some time for the new custom domain to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
+    ![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name-cname-wildcard.png)
 
-Select the **+** icon again to add another custom domain that matches the wildcard domain. For example, add `sub2.contoso.com`.
+    It might take some time for the new custom domain to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
 
-![CNAME record added](./media/app-service-web-tutorial-custom-domain/cname-record-added-wildcard2.png)
+1. Select the **+** icon again to add another custom domain that matches the wildcard domain. For example, add `sub2.contoso.com`.
 
-> [!NOTE]
-> A **Note Secure** label for your custom domain means that it's not yet bound to a TLS/SSL certificate, and any HTTPS request from a browser to your custom domain will receive and error or warning, depending on the browser. To add a TLS binding, see [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md).
+    ![CNAME record added](./media/app-service-web-tutorial-custom-domain/cname-record-added-wildcard-2.png)
 
+    > [!NOTE]
+    > A warning label for your custom domain means that it's not yet bound to a TLS/SSL certificate, and any HTTPS request from a browser to your custom domain will receive and error or warning, depending on the browser. To add a TLS binding, see [Secure a custom DNS name with a TLS/SSL binding in Azure App Service](configure-ssl-bindings.md).
+    
 ## Test in browser
 
 Browse to the DNS name(s) that you configured earlier (for example, `contoso.com`,  `www.contoso.com`, `sub1.contoso.com`, and `sub2.contoso.com`).

articles/app-service/manage-custom-dns-migrate-domain.md

@@ -5,7 +5,7 @@ tags: top-support-issue
 
 ms.assetid: 10da5b8a-1823-41a3-a2ff-a0717c2b5c2d
 ms.topic: article
-ms.date: 10/21/2019
+ms.date: 08/25/2020
 ms.custom: seodec18
 
 ---
@@ -56,31 +56,27 @@ In your DNS records page, note the record type of the DNS name you want to migra
 
 ### Enable the domain for your app
 
-In the [Azure portal](https://portal.azure.com), in the left navigation of the app page, select **Custom domains**. 
+1. In the [Azure portal](https://portal.azure.com), in the left navigation of the app page, select **Custom domains**. 
 
-![Custom domain menu](./media/app-service-web-tutorial-custom-domain/custom-domain-menu.png)
+    ![Custom domain menu](./media/app-service-web-tutorial-custom-domain/custom-domain-menu.png)
 
-In the **Custom domains** page, select the **+** icon next to **Add hostname**.
+1. In the **Custom domains** page, select **Add custom domain**.
 
-![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
+    ![Add host name](./media/app-service-web-tutorial-custom-domain/add-host-name-cname.png)
 
-Type the fully qualified domain name you want to migrate, that corresponds to the TXT record you create, such as `contoso.com`, `www.contoso.com`, or `*.contoso.com`.
+1. Type the fully qualified domain name you want to migrate, that corresponds to the TXT record you create, such as `contoso.com`, `www.contoso.com`, or `*.contoso.com`. Select **Validate**.
 
-Select **Validate**.
+    The **Add custom domain** button is activated. 
 
-The **Add hostname** button is activated. 
+1. Make sure that **Hostname record type** is set to the DNS record type you want to migrate. Select **Add hostname**.
 
-Make sure that **Hostname record type** is set to the DNS record type you want to migrate.
+    ![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name-cname.png)
 
-Select **Add hostname**.
+    It might take some time for the new hostname to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
 
-![Add DNS name to the app](./media/app-service-web-tutorial-custom-domain/validate-domain-name-cname.png)
+    ![CNAME record added](./media/app-service-web-tutorial-custom-domain/cname-record-added.png)
 
-It might take some time for the new hostname to be reflected in the app's **Custom domains** page. Try refreshing the browser to update the data.
-
-![CNAME record added](./media/app-service-web-tutorial-custom-domain/cname-record-added.png)
-
-Your custom DNS name is now enabled in your Azure app. 
+    Your custom DNS name is now enabled in your Azure app. 
 
 ## Remap the active DNS name
 
@@ -94,8 +90,6 @@ If you are remapping a CNAME record, skip this section.
 
 To remap an A record, you need the App Service app's external IP address, which is shown in the **Custom domains** page.
 
-Close the **Add hostname** page by selecting **X** in the upper-right corner. 
-
 In the **Custom domains** page, copy the app's IP address.
 
 ![Portal navigation to Azure app](./media/app-service-web-tutorial-custom-domain/mapping-information.png)