Acrolinx improvements.

Author: Adrian Hall

articles/static-web-apps/custom-domain-azure-dns.md

@@ -11,16 +11,16 @@ ms.author: cshoe
 
 # Set up a custom domain with Azure DNS in Azure Static Web Apps
 
-By default, Azure Static Web Apps provides an auto-generated domain name for your website, but you can point a custom domain to your site. Free SSL/TLS certificates are automatically created for the auto-generated domain name and any custom domains you may add.
+By default, Azure Static Web Apps provides an autogenerated domain name for your website, but you can point a custom domain to your site. Free SSL/TLS certificates are automatically created for the autogenerated domain name and any custom domains you may add.
 
 Suppose you buy the domain `example.com` from a domain name registrar and then create a zone with the name `example.com` in Azure DNS. You want `www.example.com` to point to your Static Web Apps site.
 
-- If you are using an apex domain (a domain without a subdomain, also known as a root domain), then please follow the instructions for [configuring a custom apex domain with Azure DNS](apex-domain-azure-dns.md).
-- If you are using an external DNS provider, then please see [configuring a custom domain with external DNS](custom-domain-external.md) or [configuring a custom apex domain with external DNS](apex-domain-external.md).
+- If you're using an apex domain (a domain without a subdomain, also known as a root domain), see [configuring a custom apex domain with Azure DNS](apex-domain-azure-dns.md).
+- If you're using an external DNS provider, see [configuring a custom domain with external DNS](custom-domain-external.md) or [configuring a custom apex domain with external DNS](apex-domain-external.md).
 
 ## Prerequisites
 
-- A domain purchased from a domain name registrar and hosted on Azure DNS.  For details, see [Delegate your domain to Azure DNS](azure-dns-zone.md).
+- A domain purchased from a domain name registrar and hosted on Azure DNS. For details, see [Delegate your domain to Azure DNS](/azure/dns/dns-delegate-domain-azure-dns).
 
 ## Map the domain to your website
 
@@ -41,17 +41,17 @@ Now that your domain is hosted on Azure DNS, you can create a CNAME record for `
     | DNS zone | Select your domain name hosted on Azure DNS |
     | Subdomain | **www** |
 
-   The *Full domain* will be updated and should match the desired custom domain name.
+   The *Full domain* is updated and should match the desired custom domain name.
 
 1. Select **Add**
 
-Static Web Apps will make the necessary adjustments to the DNS zone (including adding a CNAME), then validate the changes are available.
+Static Web Apps makes the necessary adjustments to the DNS zone (including adding a CNAME), then validates the changes are available in the global DNS system.
 
 > [!WARN]
 > If you receive the message *CNAME Record is invalid*, then check that your DNS zone lists the Microsoft DNS services with your DNS registrar.  If you have recently moved the domain to Azure DNS, you may need to wait for DNS propagation before adding the custom domain.
 
 ## Validate the custom domain
 
-It may take some time for the DNS changes to propagate.  The default time for Azure DNS is 1 hour.
+It may take some time for the DNS changes to propagate. The default time for Azure DNS is 1 hour.
 
-Open a new browser and go to your domain (for example, `https://www.example.com`).  Inspect the location to verify that your site is served securely using `https`.
+Open a new browser and go to your domain (for example, `https://www.example.com`). Inspect the location to verify that your site is served securely using `https`.

articles/static-web-apps/custom-domain-external.md

@@ -11,12 +11,12 @@ ms.author: cshoe
 
 # Set up a custom domain in Azure Static Web Apps
 
-By default, Azure Static Web Apps provides an auto-generated domain name for your website, but you can point a custom domain to your site. Free SSL/TLS certificates automatically get created for the auto-generated domain name and any custom domains that you might add. This article shows how to configure your domain name with the `www` subdomain, using an external provider.
+By default, Azure Static Web Apps provides an autogenerated domain name for your website, but you can point a custom domain to your site. Free SSL/TLS certificates automatically get created for the autogenerated domain name and any custom domains that you might add. This article shows how to configure your domain name with the `www` subdomain, using an external provider.
 
 There are multiple methods of configuring a custom domain for use with Static Web Apps:
 
-- If you are using an apex domain (a domain without a subdomain, also known as a root domain), then please follow the instructions for [configuring a custom apex domain on Static Web Apps](apex-domain-external.md).
-- If you are using Azure DNS, then please see [configuring a custom domain with Azure DNS](custom-domain-azure-dns.md) or [configuring a custom apex domain with Azure DNS](apex-domain-azure-dns.md).
+- If you're using an apex domain (a domain without a subdomain, also known as a root domain), see [configuring a custom apex domain on Static Web Apps](apex-domain-external.md).
+- If you're using Azure DNS, see [configuring a custom domain with Azure DNS](custom-domain-azure-dns.md) or [configuring a custom apex domain with Azure DNS](apex-domain-azure-dns.md).
 
 > [!NOTE]
 > Static Web Apps doesn't support set-up of a custom domain with a private DNS server, hosted on-premises. Consider using an [Azure Private DNS zone](../dns/private-dns-privatednszone.md).
@@ -39,7 +39,7 @@ There are multiple methods of configuring a custom domain for use with Static We
 
 ## Create a CNAME record on your domain registrar account
 
-Domain registrars are the services you can use to purchase and manage domain names. Common providers include GoDaddy, Namecheap, Google, Tucows, and the like.
+Domain registrars are services you can use to purchase and manage domain names. To find a domain registrar, see the [ICANN list of accredited registrars](https://www.icann.org/en/accredited-registrars).
 
 1. Open a new browser tab and sign in to your domain registrar account.
 
@@ -76,8 +76,7 @@ Domain registrars are the services you can use to purchase and manage domain nam
 
 1. Select **Add**.
 
-   Azure validates that the CNAME record has been created.  This is dependent on the time to live (TTL) for your domain and make take several days.  If 
-   the validation fails, return to add the custom domain later.
+   Azure validates that the CNAME record was created correctly and is available in the global DNS system.  Propagation depends on the time to live (TTL) for your domain and make take several days. If the validation fails, return to add the custom domain later.
 
 1. When the update completes, open a new browser tab and go to your domain with the `www` subdomain.