updates

Author: craigshoemaker

articles/static-web-apps/TOC.yml

@@ -51,17 +51,9 @@
     - name: Review pull requests in pre-production environments
       href: review-publish-pull-requests.md
     - name: Custom domains
-      href: custom-domain.md
-- name: How-to guides
-  items:
-    - name: APIs
-      items:
-        - name: Add an API
-          href: add-api.md
-        - name: Bring your own functions
-          href: functions-bring-your-own.md
-    - name: Add a custom domain
       items:
+      - name: About custom domains
+        href: custom-domain.md
       - name: Use Azure DNS
         items:
         - name: Delegate your domain to Azure DNS
@@ -76,8 +68,16 @@
           href: custom-domain-external.md
         - name: Set up the apex domain
           href: apex-domain-external.md
-      - name: Set up the apex domain
+      - name: Manage the default domain
         href: custom-domain-default.md
+- name: How-to guides
+  items:
+    - name: APIs
+      items:
+        - name: Add an API
+          href: add-api.md
+        - name: Bring your own functions
+          href: functions-bring-your-own.md
     - name: Security
       items:
         - name: Set up a private endpoint

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

@@ -11,7 +11,7 @@ ms.author: cshoe
 
 # Set up an apex domain with Azure DNS in Azure Static Web Apps
 
-Domain names without a subdomain are known as apex, root, or "naked" domains. For example, the domain `www.example.com` is the `www` subdomain joined with the `example.com` apex domain.
+Domain names without a subdomain are known as apex or root domains. For example, the domain `www.example.com` is the `www` subdomain joined with the `example.com` apex domain.
 
 This guide demonstrates how to use `TXT` and `ALIAS` records to configure your apex domain in Azure DNS.
 

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

@@ -11,7 +11,7 @@ ms.author: cshoe
 
 # Set up an apex domain in Azure Static Web Apps
 
-Domain names without a subdomain are known as apex, root, or "naked" domains. For example, the domain `www.example.com` is the `www` subdomain joined with the `example.com` apex domain.
+Domain names without a subdomain are known as apex or root domains. For example, the domain `www.example.com` is the `www` subdomain joined with the `example.com` apex domain.
 
 Some domain registrars (like Google and GoDaddy) don't allow you to point the apex domain to an existing URL. If your registrar doesn't support `ALIAS` or `ANAME` records, or doesn't allow `CNAME` flattening, then you can't point your apex domain to the generated URL for your static web app.
 

articles/static-web-apps/azure-dns-zone.md

@@ -21,7 +21,7 @@ The following procedure requires you to copy settings from an Azure DNS zone you
 
 ## Create an Azure DNS zone
 
-1. Log in to the [Azure portal](https://portal.azure.com).
+1. Sign in to the [Azure portal](https://portal.azure.com).
 
 1. From the top search bar, enter **DNS zones**.
 

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

@@ -15,7 +15,7 @@ By default, Azure Static Web Apps provides an auto-generated domain name for you
 
 ## Preparation
 
-Before you begin, consider how you want to support your apex domain. Domain names without a subdomain are known as apex, root, or "naked" domains. For example, the domain `www.example.com` is the `www` subdomain joined with the `example.com` apex domain.
+Before you begin, consider how you want to support your apex domain. Domain names without a subdomain are known as apex, root domains. For example, the domain `www.example.com` is the `www` subdomain joined with the `example.com` apex domain.
 
 Setting up an apex domain is a common scenario to configure once your domain name is set up. Creating an apex domain is achieved by configuring an `ALIAS` or `ANAME` record or through `CNAME` flattening. Some domain registrars like GoDaddy and Google don't support these DNS records. If your domain registrar doesn't support the all the DNS records you need, consider using [Azure DNS to configure your domain](custom-domain-azure-dns.md).
 

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

@@ -15,22 +15,32 @@ By default, Azure Static Web Apps provides an auto-generated domain name for you
 
 When you map a custom domain to a static web app, you have a few options available to you. You can configure subdomains and an apex domain.
 
-Given the domain `www.example.com`, the `www` prefix is known as the subdomain, while the remaining segment of `example.com` is referred to as the apex domain.
+The following table includes links to articles that demonstrate how to configure a custom domain based provider type. <sup>1</sup>
 
-As configure your domains, consider how you want to support your apex domain.
+| Action | Using... | Using... |
+|--|--|--|
+| Setup a domain with the `www` subdomain | [Azure DNS](custom-domain-azure-dns.md) | [External provider](custom-domain-external.md) |
+| Setup an apex domain | [Azure DNS](apex-domain-azure-dns.md) | [External provider](apex-domain-external.md) |
+
+<sup>1</sup> Some registrars like GoDaddy and Google don't support domain records that affect how you configure your apex domain. Consider using Azure DNS with these registrars to setup your apex domain.
+
+## About domains
 
 Setting up an apex domain is a common scenario to configure once your domain name is set up. Creating an apex domain is achieved by configuring an `ALIAS` or `ANAME` record or through `CNAME` flattening. Some domain registrars like GoDaddy and Google don't support these DNS records. If your domain registrar doesn't support the all the DNS records you need, consider using [Azure DNS to configure your domain](custom-domain-azure-dns.md).
 
 When setting up a custom domain, set up the `www` subdomain first, and then configure the apex domain.
 
-## Configuring domains
+The following are terms you'll encounter as your set up a custom domain.
 
-The following table includes links to articles that demonstrate how to configure a custom domain.
+* **Apex or root domains**: Given the domain `www.example.com`, the `www` prefix is known as the subdomain, while the remaining segment of `example.com` is referred to as the apex domain.
 
-| Action | Using... | Using... |
-|--|--|--|
-| Setup a domain with the `www` subdomain | [Azure DNS](custom-domain-azure-dns.md) | [External provider](custom-domain-external.md) |
-| Setup an apex domain | [Azure DNS](apex-domain-azure-dns.md) | [External provider](apex-domain-external.md) |
+* **Domain registrar**: A registrar verifies the availability of a domain sells the rights to purchase a domain name.
+
+* **DNS zone**: A Domain Name System (DNS) zone hosts the DNS records associated to a specific domain. There are a variety of records available which direct traffic for different purposes. For example, the domain `example.com` may contain several DNS records. One record handles traffic for `mail.example.com` (for a mail server), and another `www.contoso.com` (for a website).
+
+* **DNS hosting**: A DNS host maintains DNS servers which resolve a domain name to a specific IP address.
+
+* **Name server**: A name server is responsible for storing the DNS records for a domain.
 
 ## Next steps